Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
★ 7,868⑂ 479👁 25⑃ 2,090● 899▤ 157
+55
Daily
7,868
stars
479
forks
25
watchers
2,090
prs
899
issues
157
releases
README
Breaking change (v7.3.0): ha_config_set_yaml has been moved to beta.
HA-MCP — Manage Home Assistant with AI
Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.
---
!Demo with Claude Desktop
---
🚀 Get Started
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):
Quick start:
Only the current stable Home Assistant release is officially supported. Older releases down to 2026.8.0, the technical floor, may or may not run but are not officially supported. A beta release may be supported, but that is not guaranteed; where it is, a fallback keeps current stable working.
1. Install the HA-MCP integration (requires Home Assistant 2026.8.0 or newer; see compatibility details). On Home Assistant 2026.8–2026.10, open HACS, search for HA-MCP, then Download.
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 receiving the same releases. On the Marketplace, keep GitHub connected for its background checks on that custom repository.
Older installed releases may still appear as HA-MCP Custom Component; searching for HA-MCP matches both names.
2. Restart Home Assistant.
3. Decide which administrator account the server acts as. Either create a long-lived access token on your own account (your profile → Security → Long-lived access tokens → Create token; it works from anywhere if it leaks, and the server's changes show under your name), or, safer, create an account just for HA-MCP under Settings → People → Add person with Allow login, Local access only and Administrator on. Never use your own login for the second option.
4. Go to Settings → Devices & Services → Add Integration, search for HA-MCP and choose HA-MCP Server. Paste your token, or enter the user name and password of the account you made for HA-MCP (HA-MCP creates its token), pick how clients may connect — Remote access through Home Assistant (start with Secret URL, the simplest; Home Assistant sign-in adds a login) and/or Network access: Local network — then click Submit. Both start disabled, so a client on another device needs one of thTop issues
#2632[FEATURE] Use native HA Core APIs, schemas, and flows for read and write tools35 comments · 2026-10-03#1237Dependency Dashboard8 comments · 2026-05-11#2969[FEATURE] A switch for Read Only Mode so it can flip back automatically6 comments · 2026-11-05#2653[FEATURE] Webhook Proxy app: callback allowlist for none-mode OAuth auto-approve5 comments · 2026-10-04#3038[FEATURE] Support image.* entities in snapshot/image retrieval tools3 comments · 2026-11-10#3087[FEATURE] FEAUTURE/Bug: Enable CORS headers for browser-based MCP clients2 comments · 2026-11-13#3099[FEATURE] Export/import of HA-MCP settings (to migrate from the mirror listing)1 comments · 2026-11-15#3094[BUG] Calendar event auto-backup fails with ENAMETOOLONG for long Microsoft calendar UID/recurrence IDs1 comments · 2026-11-14
Discussions
#3084Turkish video about ha-mcp (with English subtitles)0 comments · 2026-11-13#3079Using with local llm running on rtx 2060 6gb1 comments · 2026-11-12#2984Migration path to this repo1 comments · 2026-11-06#2936Ability to add KNX entity’s1 comments · 2026-11-02#2889Return an image from a service response as an image, like ha_get_camera_image does1 comments · 2026-10-27#2874Can HA's core MCP integration & ha-mcp co-exist?2 comments · 2026-10-26#2825Community integration: connect Microsoft Copilot Chat & Cowork to ha-mcp1 comments · 2026-10-24#2819Webhook Proxy (Nabu Casa) + claude.ai connector: 404 / "no MCP server found" while browser GET shows server is up2 comments · 2026-10-24
Latest release
v9.2.0 v9.2.0 2026-11-11Added - helpers: Answer helper flows on Core's own flow and send storage fields to Core as written (3050) - Build on Python 3.14 and run the unit tests on real Home Assistant Core (3009) - services: Take ha_list_services from Core's own descriptions (2632) (2988) - files: Edit stored text files with exact-match search/replace (2976) Changed - Fix license badge link to point to LICENSE file (3061) - Say the integration mirror stays supported (3040) Fixed - Read ha_get_history times without an offset as Home Assistant local time (3059) - Name entities in search and the overv