homeassistant-ai/ha-mcp
Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
The recommended way to run ha-mcp is the HA-MCP integration. It installs into Home Assistant through HACS (the built-in Marketplace on Home Assistant 2026.11+), 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 or, on Home Assistant 2026.11+, the Marketplace (the preferred install): [](https://my.home-assistant.io/redirect/hacsrepository/?owner=homeassistant-ai&repository=ha-mcp&category=integration) Quick start: On Home Assistant 2026.11 or newer, open Settings → Marketplace, accept its first-run warning, and search for HA-MCP, then Install. HA-MCP is in the default catalog, so installing it and receiving its updates do not require connecting GitHub or adding a custom repository. The badge above also opens its catalog page. Already installed from the earlier homeassistant-ai/ha-mcp-integration repository? It keeps…
Read the full README ↗ · Preview checked 2026-11-09T15:51:24.484Z
Inside the original README — Document outline
- HA-MCP — Manage Home Assistant with AI
- 🚀 Get Started
- 🏠 Home Assistant app (add-on)
- Other install methods
- 🧪 Demo server (Windows / macOS / Linux)
- 🧙 Setup Wizard for 15+ clients
- 💬 What Can You Do With It?
- ✨ Features
- 🆚 ha-mcp vs. Home Assistant's built-in MCP Server
- 🔌 Custom Component (hamcptools) — File & YAML Services
- Install
- 🧠 Better Results with Agent Skills
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
Repository facts
- Owner
- homeassistant-ai
- Primary language
- Python
- Stars
- 5,554
- Forks
- 273
- Open issues + pull requests
- 19
- License
- MIT
- Archived
- No
- Default branch
- master
- Created
- 2025-09-14T13:23:45.000Z
- Last push
- 2026-11-09T10:49:09.000Z
Topics and intended use
Owner-supplied topics: ai, claude, hacs, home-assistant, home-automation, llm, mcp, model-context-protocol
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-11-09T12:18:59.175Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer