{"data":{"slug":"homeassistant-ai-ha-mcp","name":"ha-mcp","tagline":"Unofficial Home Assistant MCP Server for AI model integration","github_url":"https://github.com/homeassistant-ai/ha-mcp","owner":"homeassistant-ai","repo":"ha-mcp","owner_avatar_url":"https://avatars.githubusercontent.com/u/232192432?v=4","primary_language":"Python","stars":4790,"forks":217,"topics":["ai","claude","hacs","home-assistant","home-automation","llm","mcp","model-context-protocol"],"archived":false,"github_pushed_at":"2026-09-19T22:46:41+00:00","maintenance_label":"Very active","stars_delta_30d":668,"url":"https://www.graphcanon.com/tools/homeassistant-ai-ha-mcp","markdown_url":"https://www.graphcanon.com/tools/homeassistant-ai-ha-mcp.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/homeassistant-ai-ha-mcp","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=homeassistant-ai-ha-mcp","description":"The Unofficial and Awesome Home Assistant MCP Server","homepage_url":"https://homeassistant-ai.github.io/ha-mcp/","license":"MIT","open_issues":16,"watchers":20,"ai_summary":"The repository provides unofficial support for integrating AI models into Home Assistant through the Model Context Protocol (MCP). It supports frameworks like Claude.","readme_excerpt":"### Other install methods\n\nThese run the server outside Home Assistant — useful for **Container** / **Core** installs (which can't run apps) or a separate host. The [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) generates the exact client-specific config for each.\n\n- **Docker (HTTP server):** run `ghcr.io/homeassistant-ai/ha-mcp` in HTTP mode, pointed at your Home Assistant URL and a long-lived token, and connect your client to its secret URL. See the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) for the full command and per-client config.\n- **PyPI / uvx (HTTP server):** run the published `ha-mcp` package with `uvx ha-mcp@latest` (or pip) as a streamable-HTTP server the same way. Details in the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).\n- **Local stdio (not recommended):** runs ha-mcp on your own machine over stdio. The one-command installers in the **Demo server** section below use this path; the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/) covers connecting it to your own Home Assistant.\n- **OIDC authentication:** gate remote access behind an external identity provider (Authentik, Keycloak, Auth0, etc.) instead of a secret URL — all authenticated users share the server's Home Assistant credentials. See [OIDC Mode](docs/oidc.md).\n\n  > ⚠️ **stdio has known transport issues.** The stdio transport has connection problems that streamable HTTP does not ([#1713](https://github.com/homeassistant-ai/ha-mcp/issues/1713)). It is recommended only for demo/testing tinkering — for a real setup, use the custom component or an HTTP method above.\n\n<details>\n<summary><b>🌐 Remote access (Nabu Casa / Webhook Proxy app / OpenAI Tunnel)</b></summary>\n\n> **Using the HA-MCP custom component?** You do not need the **Webhook Proxy** — the component has its own built-in webhook for remote access (see the **Get Started** quick start at the top). The proxy is for the **app** (it can also front another external server via its `mcp_server_url` option). The **OpenAI Tunnel** below is different: it applies to **any** install method when Home Assistant isn't publicly reachable at all (no Nabu Casa or reverse proxy).\n\nAlready have **Nabu Casa** or another reverse proxy pointing at your Home Assistant? The Webhook Proxy app routes MCP traffic through your existing setup — no separate tunnel or port forwarding needed.\n\n1. Install the **MCP Server app** (see above) and the **Webhook Proxy** app from the same store\n2. Start the webhook proxy and **restart Home Assistant** when prompted\n3. Copy the webhook URL from the app logs:\n   ```\n   MCP Server URL (remote): https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx\n   ```\n4. Configure your AI client with that URL\n\nFor other remote access methods (Cloudflare Tunnel, custom reverse proxy), see the [Setup Wizard](https://homeassistant-ai.github.io/ha-mcp/setup/).\n\n**ChatGPT / Codex behind a firewall (OpenAI Tunnel).** ChatGPT connectors normally require a publicly reachable URL. If you can't (or don't want to) expose one, the community [OpenAI Tunnel for HA-MCP](https://github.com/norpol/hass-codex-tunnel-mcp) integration by [@norpol](https://github.com/norpol) runs OpenAI's [`tunnel-client`](https://github.com/openai/tunnel-client) inside Home Assistant and connects your local MCP server URL to an OpenAI-hosted tunnel over an outbound-only connection — no port forwarding, reverse proxy, or public URL. Point it at your ha-mcp URL, then attach the ChatGPT connector to the same tunnel ID. See the [FAQ entry](https://homeassistant-ai.github.io/ha-mcp/faq/#openai-tunnel) and [#1811](https://github.com/homeassistant-ai/ha-mcp/issues/1811).\n\n[Webhook proxy documentation →](https://github.com/homeassistant-ai/ha-mcp/blob/master/homeassistant-addon-webhook-proxy/DOCS.md)\n\n</details>\n\n---\n\n### Install\n\nInstall the **HA-MCP File & YAML Tools** entry from the same **HA-MCP Custom Component**:\n\n\n\nTo add manually: open **HACS** > **Integrations** > th","github_created_at":"2025-09-14T13:23:45+00:00","created_at":"2026-07-11T11:50:32.413872+00:00","updated_at":"2026-09-20T06:40:19.885957+00:00","categories":[{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"},{"slug":"llm-frameworks","name":"LLM Frameworks","url":"https://www.graphcanon.com/categories/llm-frameworks","markdown_url":"https://www.graphcanon.com/categories/llm-frameworks.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/llm-frameworks"}],"tags":[{"slug":"ai","name":"ai"},{"slug":"claude","name":"claude"},{"slug":"hacs","name":"hacs"},{"slug":"home-assistant","name":"home-assistant"},{"slug":"home-automation","name":"home-automation"},{"slug":"llm","name":"llm"},{"slug":"mcp","name":"mcp"},{"slug":"model-context-protocol","name":"model-context-protocol"}],"trust":{"provenance":{"is_fork":false,"github_id":1056618941,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T03:52:08.655Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":26,"days_since_push":0,"last_release_at":"2026-09-19T22:46:33Z","stars_delta_30d":668,"open_issues_delta_30d":7},"security_summary":{"status":"no_manifest","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:50:33.524Z","medium_count":0,"scan_profile":"mcp_manifest","critical_count":0}},"capability_facts":{"mcp":{"source":"repo_scan","observed_at":"2026-09-20T03:52:09.676Z","server_manifest":false},"scan":{"source":"repo_scan","observed_at":"2026-09-20T03:52:09.676Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-09-20T03:52:09.676Z","managed_saas":false},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-09-20T03:52:09.676Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-09-20T03:52:09.676Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-09-20T03:52:09.676Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T03:52:09.676Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["When you need to integrate Claude AI models as an MCP component in your Home Assistant setup.","For users who wish to experiment with new and unofficial MCP-supported models not officially supported by Home Assistant."],"when_not_to_use":["If official support for AI model integration is required, since ha-mcp lacks this endorsement.","Not suitable if you prioritize stability over experimenting with cutting-edge functionalities."],"source":"enrich:decision_facts","observed_at":"2026-07-16T18:51:10.503Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"ha-mcp provides unofficial support for integrating AI models, specifically those from frameworks like Claude, into Home Assistant via the Model Context Protocol (MCP)."}]}}