ha-mcp: what it is, what problem it solves & why it's gaining traction

What it solves

This project provides a way for AI assistants to interact with Home Assistant using the Model Context Protocol (MCP). While Home Assistant has a built-in MCP server for basic device control, this server allows AI agents to not only control devices but also configure, build, and debug the entire smart home setup, including automations, scripts, and dashboards.

How it works

The server acts as a bridge between an AI client (like Claude Desktop or ChatGPT) and Home Assistant. It exposes over 85 tools that the AI can use to query states, execute services, and modify the system configuration. For advanced tasks like editing YAML files or accessing the filesystem, it utilizes a companion custom component (ha_mcp_tools) installed within Home Assistant.

Who it’s for

Smart home enthusiasts and Home Assistant users who want to use natural language to manage their home automation, create complex automations, and debug their system without manually editing configuration files or the UI.

Highlights

• Comprehensive Control: Manage everything from devices and areas to dashboards, blueprints, and HACS.
• Configuration Management: Create, edit, and delete automations, scripts, and scenes via natural language.
• System Debugging: Analyze automation traces, read logs, and check system health.
• Flexible Deployment: Available as a Home Assistant OS add-on, Docker container, or pip package.
• Search-Based Discovery: Includes a mode for smaller LLMs to search for tools on-demand rather than loading the entire catalog into context.
• Safety Features: Includes a Read Only Mode, tool security policies, and automatic backups for edits.