ha-mcp is a Model Context Protocol server that enables AI assistants to interact with Home Assistant through natural language commands.
The tool solves the problem of giving large language models the ability to control and query smart home devices managed by Home Assistant. It works by implementing the Model Context Protocol, which allows AI assistants like Claude to call tools that interact with Home Assistant's devices, services, and automations. Users can describe what they want in natural language, and the server translates those requests into Home Assistant API calls to control lights, switches, sensors, and other smart home components.
The recommended installation method is through the HA-MCP Custom Component, which integrates directly into Home Assistant via HACS and runs in-process on any Home Assistant installation type—OS, Supervised, Container, or Core. This approach eliminates the need to manage separate access tokens and works identically across all installation methods. The tool is designed for anyone running Home Assistant who wants to add AI-driven natural language control to their smart home setup.
The project maintains active development with regular commits and end-to-end test coverage. Recent changes include moving certain configuration functions to beta status as the tool evolves. The codebase is built on FastMCP and written in Python, indicating a focus on leveraging established frameworks for protocol implementation.
