Home Assistant MCP Server
The unofficial and awesome Model Context Protocol (MCP) server for Home Assistant. Enables AI assistants like Claude, Cursor, and Gemini to control your smart home using natural language — lights, sensors, automations, dashboards, and more.
Overview
ha-mcp (The Unofficial and Awesome Home Assistant MCP Server) is the leading community-built Model Context Protocol server that turns your Home Assistant instance into a powerful tool for AI assistants. It allows LLMs like Claude, Cursor, Gemini CLI, and any MCP-compatible client to interact directly with your smart home using natural language.
While Home Assistant now includes an official mcp_server integration, ha-mcp provides significantly richer capabilities (80+ tools), an easy HA OS Add-on, and a dedicated setup wizard — making it the go-to choice for most users.
Key Features
- Natural Language Control: Turn lights on/off, adjust climate, open covers, play media, and execute any service.
- Real-time State & Entity Queries: Ask for sensor values, device status, or full home summaries.
- Automation Management: Create, edit, enable/disable, trigger, or pause automations dynamically.
- Advanced Capabilities: YAML editing, HACS management, Lovelace dashboard generation, update handling, backups, and 80+ specialized tools.
- Multi-Client Support: Works seamlessly with Claude Desktop, Cursor, VS Code + Cline, Gemini CLI, and more.
- Easy Installation: Official HA OS Add-on, Docker, or quick-run options.
- Secure & Reliable: Uses long-lived access tokens with proper authentication.
Use Cases
- Hands-free Smart Home: "Turn off all lights downstairs and lock the front door."
- AI-Driven Automations: "Create an automation that turns on the porch light at sunset and notifies me."
- Dashboard & Config Editing: Let Cursor or Claude generate and deploy Lovelace dashboards or YAML configs.
- Monitoring & Troubleshooting: "What's the current temperature in the bedroom and why is the motion sensor offline?"
- Complex Workflows: Combine with other MCP servers for full AI-orchestrated home + development pipelines.
Installation (Easiest Method)
Home Assistant OS Add-on
- Add repository
https://github.com/homeassistant-ai/ha-mcpin your HA Add-on Store. - Install and start the Home Assistant MCP Server add-on.
- Generate a long-lived access token and configure it.
- Use the official setup wizard: https://homeassistant-ai.github.io/ha-mcp/setup/
Alternative options: Docker, uvx, or manual install from the repo.
Compatibility
- Clients: Claude Desktop, Cursor, Gemini CLI, Codex, any MCP-compliant app.
- Home Assistant: Works with current HA versions (OS, Container, Core).
- License: Open-source (check repo for exact terms).
Community & Alternatives
This is the most actively maintained and feature-rich version (v7.1.0+ as of March 2026). Other community forks exist, but ha-mcp from the homeassistant-ai organization is the one most recommended across forums, YouTube, and Reddit.
The official Home Assistant mcp_server integration is also available for lighter use cases.
Start controlling your smart home with AI today — ha-mcp makes it simple, powerful, and fun.