ha-mcp
ha-mcp is a community MCP server for running and configuring a Home Assistant instance, maintained in the homeassistant-ai GitHub organisation rather than by the Home Assistant project.
What it does
ha-mcp is a community MCP server for running and configuring a Home Assistant instance, maintained in the homeassistant-ai GitHub organisation rather than by the Home Assistant project. Its recommended setup is an integration, installed through HACS or the Home Assistant Marketplace, that runs the server inside Home Assistant and gives clients a webhook or local network address. It can also run as an app (add-on), a Docker container, a PyPI package or a local stdio process. Because it acts as an administrator, it needs an admin token or a dedicated admin account. A read-only mode and per-tool switches limit what the AI may change.
Capabilities
- Search entities and read live states
- Call any service and control devices in bulk
- Create and edit automations, scripts, helpers and dashboards
- Read history, statistics and automation traces
- Manage backups, updates and apps (add-ons)
About
- Publisher
- homeassistant-ai
- Tool
- Home Assistant
Install
- Run this to add it to Any client:
uvx --python 3.14 ha-mcp@latest
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Home Assistant | |
| Publisher | homeassistant-ai | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local or remote | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop, Cursor, Visual Studio Code, ChatGPT, Gemini CLI | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 18, 2026Version 9.2.07,959 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository pypi: ha-mcpdocker: ghcr.io/homeassistant-ai/ha-mcp |
More from homeassistant-ai
1 server · 1 skill
All 2 from homeassistant-ai →Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/servers/homeassistant-ai-ha-mcp/)
Sources
- README (README.md)github.com/homeassistant-ai/ha-mcp · Backs: AI clients, Can change data, Connection, Licence, Needs an API key or sign-in, Official status, PublisherNov 12, 2026
- GitHub repositorygithub.com/homeassistant-ai/ha-mcp · Backs: Activity, LicenceNov 18, 2026
- MCP Registry entryio.github.homeassistant-ai/ha-mcp · Backs: ConnectionNov 18, 2026
- PyPI package recordpypi.org/project/ha-mcpNov 18, 2026