homeassistant-ai/ha-mcp
The Unofficial and Awesome Home Assistant MCP Server
What it solves
AI assistants typically only have limited access to smart home devices. This project provides a comprehensive Model Context Protocol (MCP) server that allows LLMs to go beyond simple device control to actually manage, configure, and debug a Home Assistant instance using natural language.
How it works
The server acts as a bridge between an MCP-compatible AI client (like Claude Desktop, ChatGPT, or Cursor) and a Home Assistant installation. It exposes over 85 specialized tools that allow the AI to interact with the system. It can be installed as a Home Assistant custom component, an add-on, via Docker, or through PyPI.
Who it’s for
- Smart Home Enthusiasts who want to use AI to create automations, scripts, and scenes.
- Power Users looking to debug automations using execution traces and logs.
- Developers who want to use AI to build and edit dashboards, manage helpers, or configure system settings via natural language.
Highlights
- Deep Configuration: Enables AI to create/edit automations, scripts, scenes, and dashboards.
- System Management: Allows management of add-ons, backups, HACS, and device registries.
- Advanced Debugging: Provides access to automation traces, logs, and history for troubleshooting.
- Broad Compatibility: Supports various installation methods including in-process custom components and Docker.
- Security Features: Includes a Read-Only mode, per-tool enable/disable options, and user approval policies.