homeassistant-ai/ha-mcp
The Unofficial and Awesome Home Assistant MCP Server
Build with Backblaze B2
SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.
Loading star history...
Where it stands
Rank, growth pace and release cadence relative to everything GStars tracks.
5 releases in the last 90 days, the latest today, with 87 contributors on GitHub.
Use Cases & Benefits
- Provides a comprehensive Model Context Protocol server enabling AI assistants to interact with Home Assistant for smart home control and automation management.
- Offers full feature parity across all Home Assistant installation types with in-process server integration, surpassing built-in MCP by enabling configuration, debugging, and advanced management.
- Use for natural language control and creation of automations, scripts, and dashboards within Home Assistant via AI assistants like Claude or ChatGPT.
- Use for managing and debugging Home Assistant setups including automation traces, device registries, backups, and system updates through AI-driven commands.
- Use for integrating AI assistants with Home Assistant remotely or locally using multiple deployment methods including custom component, app add-on, Docker, or PyPI server.
Should you depend on it?
License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.
License
MIT
Permissive: commercial use, modification and redistribution are allowed with attribution.
Community files
- README: present
- Contributing guide: present
Watch-outs
No watch-outs from GStars' checks.
General guidance from repository metadata, not legal advice. How we score
From the README
Breaking change (v7.3.0):
ha_config_set_yamlhas been moved to beta.A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
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, and works on every Home Assistant installation type — Home Assistant OS, Supervised, Container, and Core — with full feature parity. It is the easiest setup in every case: setup asks for an administrator access token and how clients may connect.
Add it to Home Assistant via HACS (the preferred install):
The setup below is for version 9.0.0 (October 28, 2026) and later; earlier versions show a shorter setup form without the administrator account step.
Connect URL. The Configure screen gives you a Home Assistant webhook URL for remote clients —
https://<your-ha-domain>/api/webhook/<webhook-id>through Nabu Casa or any reverse proxy already pointed at Home Assistant (locally,http://<ha-host>:8123/api/webhook/<webhook-id>). For clients on the same network, the server is also reachable directly athttp://<ha-ip>:9584/private_<random>.The component's second entry type, the File & YAML services entry (HA-MCP File & YAML Tools), is only needed if you enable ha-mcp's opt-in file and YAML editing tools (feature flags, off by default) — skip it otherwise; you can add it later at any time. It works with any server type (in-process, app, Docker, or stdio).
Compared with peers in AI
Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth
| Repository | Stars | +7d | Health | Last release |
|---|---|---|---|---|
| thedotmack/claude-mem | 113.6K | +8.8K | 35 | today |
| D4Vinci/Scrapling | 98.1K | +6.9K | 65 | 1 day ago |
| Leonxlnx/taste-skill | 110.7K | +5.2K | 55 | 1 day ago |
| calesthio/OpenMontage | 77.2K | +4.2K | 40 | — |
| heygen-com/hyperframes | 79.6K | +4.1K | 45 | today |
| homeassistant-ai/ha-mcp | 5.3K | — | 40 | today |
| Category median | 98.1K | +5.2K | 45 | — |
Discover Repositories
Search across tracked repositories by name or description