Configure and automate Home Assistant with Claude, ChatGPT, and other AI assistants.

★ 7,868⑂ 479👁 25⑃ 2,090● 899▤ 157
PythonMITCreated 2025-09-14homeassistant-ai.github.io/ha-mcp/
下载:v9.2.0v9.2.0 ↓9.2.02026-11-11
+55
日增长
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 th

Top issues

Discussions

Latest release

v9.2.0 v9.2.0 2026-11-11
Added

- 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON