ha-mcp
The Unofficial and Awesome Home Assistant MCP Server
ha-mcp is an unofficial MCP server that connects AI assistants to Home Assistant, enabling natural language control and configuration of smart home devices. It provides 87+ tools for controlling devices, creating automations, managing dashboards, debugging issues, and administering the entire Home Assistant instance. Built with FastMCP, it supports multiple installation methods including a custom Home Assistant component, add-on, Docker, and stdio connections. The server can be used with Claude Desktop, ChatGPT, Cursor, and other MCP-compatible clients to voice-control devices, build automations, edit dashboards, and troubleshoot smart home setups.
Key Features
Use Cases
- 01Control smart home devices through natural language conversations with AI assistants
- 02Create and modify Home Assistant automations, scripts, and scenes without manual YAML editing
- 03Build and edit Lovelace dashboards by describing desired layouts to an AI
- 04Debug automation issues by analyzing execution traces and system logs through AI assistants
- 05Manage Home Assistant configuration including helpers, areas, zones, groups, and integrations
- 06Monitor system health, view history and statistics, and manage backups through conversational AI
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
ha-mcp — FAQ
What is ha-mcp?+
ha-mcp is an MCP server that connects AI assistants to Home Assistant, enabling natural language control and configuration of smart home devices. It provides 87+ tools for device control, automation creation, dashboard editing, and system administration.
How do I install ha-mcp?+
The recommended method is installing the HA-MCP Custom Component through HACS, which runs the server in-process within Home Assistant. Alternatively, you can use the Home Assistant add-on (for OS/Supervised), Docker, or uvx/PyPI for external installations.
Which AI clients work with ha-mcp?+
ha-mcp works with Claude Desktop, Claude Code, claude.ai, ChatGPT, Codex, Cursor, Windsurf, VSCode, Open WebUI, Gemini CLI, GitHub Copilot CLI, and any MCP-compatible client. A setup wizard provides client-specific configuration for 15+ clients.
Do I need API keys or a Home Assistant token?+
The custom component and Home Assistant add-on require no API keys or tokens—they access Home Assistant directly. External installations (Docker, uvx) require a Home Assistant URL and long-lived access token from your Home Assistant user profile.
Is ha-mcp free?+
Yes, ha-mcp is open source and free under the MIT License. It runs locally on your network with no telemetry or data collection.
What's the difference between ha-mcp and Home Assistant's built-in MCP Server?+
Home Assistant's built-in MCP integration only controls devices exposed to Assist. ha-mcp provides full configuration capabilities including creating/editing automations, scripts, dashboards, helpers, debugging from traces, managing backups, and administering the entire Home Assistant instance.
How do I install ha-mcp?+
Open the source repository on GitHub and follow its README. ha-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is ha-mcp free?+
ha-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.