Verified project record

homeassistant-ai/ha-mcp

This MCP server bridges AI assistants with Home Assistant to enable deep configuration, building, and debugging of smart home setups via natural language. It goes beyond simple device control, allowing AI to manage automations and edit dashboards.

Project overview

It provides AI assistants with full configuration and debugging capabilities for Home Assistant environments, rather than limiting them to basic device control.

Project type: MCP · AI Agent
Use cases: Documents & Office · Automation
Deployment: Refer to project documentation
License: MIT

Best for

General users and developers seeking deep configuration, building, and debugging capabilities for their Home Assistant setup via AI assistants.

Key capabilities

Create, edit, debug, and manage automations, scripts, helpers, and blueprints.
Build and edit Home Assistant Lovelace dashboards via AI requests.
Defers the full tool catalog behind a BM25 search interface to help smaller LLMs avoid context limits.
Bundles Home Assistant domain knowledge skills served as MCP resources.
Enables privileged tools for filesystem access and YAML configuration editing.

Limitations and risks

The stdio transport has known connection problems and is not recommended for real setups.
Running multiple install methods for the same client causes connection hangs.

Getting started

The setup difficulty is rated easy due to provided one-command install scripts for demos and a recommended HACS custom component install. The path to first success involves installing the HA-MCP Custom Component from HACS, restarting Home Assistant, adding the integration and copying the connect URL, and finally pasting the URL into the AI client.

Evidence and sources

GitHub project description: The Unofficial and Awesome Home Assistant MCP Server
README: A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
README: Using natural language, control smart home devices, query states, execute services and manage your automations.
README: Built with FastMCP
README: The recommended way to run ha-mcp is the **HA-MCP Custom Component**. It installs into Home Assistant through HACS, runs the full server **in-process**

Reviewed at: 2026-07-16T19:20:11Z

Open original GitHub project