Why this rank:Strong adoptionRecent releaseHealthy release cadence
Description
The Unofficial and Awesome Home Assistant MCP Server
README
Breaking change (v7.3.0):ha_config_set_yaml has been moved to beta.
The Unofficial and Awesome Home Assistant MCP Server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with Home Assistant.
Using natural language, control smart home devices, query states, execute services and manage your automations.
๐ Get Started
Full guide to get you started with Claude Desktop (~10 min)
No paid subscription required. Click on your operating system:
Already have Nabu Casa or another reverse proxy pointing at your Home Assistant? The Webhook Proxy add-on routes MCP traffic through your existing setup โ no separate tunnel or port forwarding needed.
Install the MCP Server add-on (see above) and the Webhook Proxy add-on from the same store
Start the webhook proxy and restart Home Assistant when prompted
Copy the webhook URL from the add-on logs:
MCP Server URL (remote): https://xxxxx.ui.nabu.casa/api/webhook/mcp_xxxxxxxx
Configure your AI client with that URL
For other remote access methods (Cloudflare Tunnel, custom reverse proxy), see the Setup Wizard.
Some tools require a companion custom component installed in Home Assistant. Standard HA APIs do not expose file system access or YAML config editing. This component provides both.
Tools that require the component:
Tool
Description
ha_config_set_yaml
Safely add, replace, or remove top-level YAML keys in configuration.yaml and package files (automatic backup, validation, and config check)
ha_list_files
List files in allowed directories (www/, themes/, custom_templates/)
All other tools work without the component. These five return an error with installation instructions if the component is missing.
These tools also require feature flags: HAMCP_ENABLE_FILESYSTEM_TOOLS=true (file tools) and ENABLE_YAML_CONFIG_EDITING=true (YAML editing). To enable the ha_install_mcp_tools installer tool, set HAMCP_ENABLE_CUSTOM_COMPONENT_INTEGRATION=true.
Install using HACS (recommended)
To add manually: open HACS > Integrations > three-dot menu > Custom repositories > add https://github.com/homeassistant-ai/ha-mcp (category: Integration) > Download.
After installing, restart Home Assistant. Then open Settings > Devices & Services > Add Integration and search for HA MCP Tools.
Install manually
Copy custom_components/ha_mcp_tools/ from this repository into your HA config/custom_components/ directory. Restart Home Assistant, then add the integration as described above.
๐ง Better Results with Agent Skills
This server gives your AI agent tools to control Home Assistant. For better configurations, pair it with Home Assistant Agent Skills โ domain knowledge that teaches the agent Home Assistant best practices.
An MCP server can create automations, helpers, and dashboards, but it has no opinion on how to structure them. Without domain knowledge, agents tend to over-rely on templates, pick the wrong helper type, or produce automations that are hard to maintain. The skills fill that gap: native constructs over Jinja2 workarounds, correct helper selection, safe refactoring workflows, and proper use of automation modes.
Bundled Skills (built-in)
Skills from homeassistant-ai/skills are bundled and served as MCP resources via skill:// URIs. Any MCP client that supports resources can discover them automatically โ no manual installation needed.
Setting
Default
Description
ENABLE_SKILLS
true
Serve skills as MCP resources. Resources are not auto-injected into context โ clients must explicitly request them.
ENABLE_SKILLS_AS_TOOLS
true
Expose skills and doc resources via list_resources/read_resource tools. Resource-capable clients can set to false to reduce tool count.
Skills can still be installed manually for clients that prefer local skill files โ see the skills repo for instructions.
๐งช Dev Channel
Want early access to new features and fixes? Dev releases (.devN) are published on every push to master.
### Added - Add ENABLE_LITE_DOCSTRINGS beta toggle ([#1259](https://github.com/homeassistant-ai/ha-mcp/pull/1259)) - Add ha_call_event tool for publishing events on the HA event bus (#996) ([#1239](https://github.com/homeassistant-ai/ha-mcp/pull/1239)) - Pinpoint backslash-escape mistake in python_sandbox errors ([#1204](https://github.com/homeassistant-ai/ha-mcp/pull/1204)) - Reject empty-trigger automations targeting scene.create ([#1187](https://github.com/homeassistant-ai/ha-mcp/pu
High
5/13/2026
v7.4.1
## ๐จ Hotfix v7.4.1 ### Fixed - **addon**: Propagate `BUILD_VERSION` to runtime so the production Home Assistant add-on reports the correct version in startup logs. Previously, `7.4.0` was shown even when running the v7.4.0 add-on because the `homeassistant-addon/Dockerfile` never set `HA_MCP_BUILD_VERSION` and the addon-publish workflow checked out the pre-semantic-release commit ([#1090](https://github.com/homeassistant-ai/ha-mcp/pull/1090)). - **ci**: Unbreak `hotfix-release.yml` semantic-re
High
5/2/2026
v7.4.0
### Added - Introduce ha_delete_helpers_integrations to consolidate helper/config-entry deletion (#1007) ([#1056](https://github.com/homeassistant-ai/ha-mcp/pull/1056)) - UAT runner ergonomics + demote fastmcp tool-failure tracebacks ([#1051](https://github.com/homeassistant-ai/ha-mcp/pull/1051)) - Add ha_manage_energy_prefs tool for Energy Dashboard CRUD ([#1048](https://github.com/homeassistant-ai/ha-mcp/pull/1048)) - Combine ha_config_list_floors and ha_config_list_areas into ha_list_
High
4/29/2026
v7.3.0.dev386
## Development Build **Version:** 7.3.0.dev386 **Commit:** 95dd658 **Branch:** master This is an automated development build. Use at your own risk. For stable releases, download from the [latest release](https://github.com/homeassistant-ai/ha-mcp/releases/latest). ### Installation **Docker (dev channel):** ```bash docker pull ghcr.io/homeassistant-ai/ha-mcp:dev ``` **PyPI (dev channel):** ```bash pip install ha-mcp-dev ```
High
4/20/2026
v7.3.0.dev385
## Development Build **Version:** 7.3.0.dev385 **Commit:** 15f74bb **Branch:** master This is an automated development build. Use at your own risk. For stable releases, download from the [latest release](https://github.com/homeassistant-ai/ha-mcp/releases/latest). ### Installation **Docker (dev channel):** ```bash docker pull ghcr.io/homeassistant-ai/ha-mcp:dev ``` **PyPI (dev channel):** ```bash pip install ha-mcp-dev ```
High
4/20/2026
v7.3.0.dev384
## Development Build **Version:** 7.3.0.dev384 **Commit:** 3ee017d **Branch:** master This is an automated development build. Use at your own risk. For stable releases, download from the [latest release](https://github.com/homeassistant-ai/ha-mcp/releases/latest). ### Installation **Docker (dev channel):** ```bash docker pull ghcr.io/homeassistant-ai/ha-mcp:dev ``` **PyPI (dev channel):** ```bash pip install ha-mcp-dev ```
High
4/19/2026
v7.3.0.dev383
## Development Build **Version:** 7.3.0.dev383 **Commit:** 2e25c38 **Branch:** master This is an automated development build. Use at your own risk. For stable releases, download from the [latest release](https://github.com/homeassistant-ai/ha-mcp/releases/latest). ### Installation **Docker (dev channel):** ```bash docker pull ghcr.io/homeassistant-ai/ha-mcp:dev ``` **PyPI (dev channel):** ```bash pip install ha-mcp-dev ```
High
4/19/2026
v7.3.0.dev382
## Development Build **Version:** 7.3.0.dev382 **Commit:** 248e51e **Branch:** master This is an automated development build. Use at your own risk. For stable releases, download from the [latest release](https://github.com/homeassistant-ai/ha-mcp/releases/latest). ### Installation **Docker (dev channel):** ```bash docker pull ghcr.io/homeassistant-ai/ha-mcp:dev ``` **PyPI (dev channel):** ```bash pip install ha-mcp-dev ```
High
4/18/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
High
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
High
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.3.0
### Added - Harden ha_config_set_yaml description and require justification ([#942](https://github.com/homeassistant-ai/ha-mcp/pull/942)) - Add python_transform support to automations and scripts ([#968](https://github.com/homeassistant-ai/ha-mcp/pull/968)) - **history**: Add offset pagination for history and statistics sources ([#964](https://github.com/homeassistant-ai/ha-mcp/pull/964)) - **site**: Redesign documentation site with professional visual identity ([#938](https://github.c
Medium
4/15/2026
v7.2.0
### Added - Add managed YAML config editing tool (ha_config_set_yaml) ([#827](https://github.com/homeassistant-ai/ha-mcp/pull/827)) - Tool explorer with taxonomy, auto-generated docs, and design mode ([#839](https://github.com/homeassistant-ai/ha-mcp/pull/839)) - Add generic add-on API proxy tool (ha_call_addon_api) ([#641](https://github.com/homeassistant-ai/ha-mcp/pull/641)) - Add support for automation/script/scene categories ([#677](https://github.com/homeassistant-ai/ha-mcp/pull/6
Medium
4/1/2026
v7.1.0
### Added - Reactive best-practice warnings on write tool calls ([#695](https://github.com/homeassistant-ai/ha-mcp/pull/695)) - Add menu_option to ha_get_helper_schema for template helper schema introspection ([#759](https://github.com/homeassistant-ai/ha-mcp/pull/759)) - Consolidate zone CRUD tools into set/remove pattern ([#643](https://github.com/homeassistant-ai/ha-mcp/pull/643)) - Config entry flow โ fix resource leak, menu flows, schema inspection, upsert ([`d804c1a`](https://git
Low
3/18/2026
v7.0.0
### Added - Fix SSRF and XSS in OAuth consent form (breaking) ([#748](https://github.com/homeassistant-ai/ha-mcp/pull/748)) - **uat**: Add ha_checks post-run verification and openai agent improvements ([#713](https://github.com/homeassistant-ai/ha-mcp/pull/713)) - Add ha_check_update_notes tool for pre-update impact review ([#595](https://github.com/homeassistant-ai/ha-mcp/pull/595)) - Include persistent notifications in ha_get_overview ([#642](https://github.com/homeassistant-ai/ha-mc
Low
3/11/2026
v6.7.2
Release v6.7.2
Low
3/4/2026
v6.7.1
Release v6.7.1
Low
2/20/2026
v6.7.0
Release v6.7.0
Low
2/17/2026
v6.6.1
Release v6.6.1
Low
2/10/2026
v6.6.0
Release v6.6.0
Low
2/10/2026
v6.5.0
Release v6.5.0
Low
2/3/2026
v6.4.0
Release v6.4.0
Low
1/27/2026
v6.3.1
Release v6.3.1
Low
1/20/2026
v6.3.0
Release v6.3.0
Low
1/17/2026
v6.2.0
Release v6.2.0
Low
1/12/2026
v5.1.0
Release v5.1.0
Low
1/7/2026
v6.0.0
Release v6.0.0
Low
1/7/2026
v5.0.6
Release v5.0.6
Low
12/28/2025
v5.0.5
## Bug Fixes ### Blueprint Automation Support (#364) Fixed `ha_config_set_automation` to properly handle Home Assistant blueprint-based automations: - โ Blueprint automations no longer require `trigger` and `action` fields - โ Empty `trigger`/`action`/`condition` arrays are automatically stripped to prevent blueprint override - โ Added comprehensive E2E tests for blueprint automation lifecycle - โ Updated documentation with blueprint automation examples **Details:** Blueprint automations onl
Low
12/24/2025
v5.0.4
Release v5.0.4
Low
12/23/2025
v5.0.3
## Bug Fixes - Resolve Docker environment variable validation error (#354) (#356) - Fixed config files to use hardcoded port/path values instead of shell-style env vars - Updated Docker docs to use `ha-mcp-web` command - Fixed `ha-mcp-sse` to use correct default port (8087) - Added documentation note about Docker port mapping This release fixes the critical Docker startup issue where containers failed with Pydantic validation errors when using `fastmcp run fastmcp-http.json`. **Full C
Low
12/23/2025
v5.0.2
Release v5.0.2
Low
12/22/2025
v5.0.1
# v5.0.1 ## โ ๏ธ Breaking Changes **Removed dashboard card manipulation tools** in favor of more powerful jq-based transformations: - โ Removed: `ha_dashboard_add_card`, `ha_dashboard_update_card`, `ha_dashboard_remove_card` - โ New: `jq_transform` parameter for surgical config edits - โ New: `ha_dashboard_find_card` helper ## โจ Features - **jq_transform for dashboards**: Use jq expressions for token-efficient, precise modifications (PR #333) - **find_card helper**: Locate cards by entity_id o
Low
12/21/2025
v4.22.1
Release v4.22.1
Low
12/18/2025
v4.22.0
Release v4.22.0
Low
12/16/2025
v4.21.0
Release v4.21.0
Low
12/11/2025
v4.20.0
Release v4.20.0
Low
12/9/2025
v4.19.0
Release v4.19.0
Low
12/7/2025
v4.18.2
Release v4.18.2
Low
12/7/2025
v4.18.1
Release v4.18.1
Low
12/7/2025
v4.18.0
Release v4.18.0
Low
12/6/2025
v4.17.1
Release v4.17.1
Low
12/6/2025
v4.17.0
Release v4.17.0
Low
12/6/2025
v4.16.2
Release v4.16.2
Low
12/6/2025
v4.16.1
Release v4.16.1
Low
12/6/2025
v4.16.0
Release v4.16.0
Low
12/6/2025
v4.15.1
Release v4.15.1
Low
12/5/2025
v4.15.0
Release v4.15.0
Low
12/5/2025
v4.14.2
Release v4.14.2
Low
12/5/2025
v4.14.1
Release v4.14.1
Low
12/5/2025
v4.14.0
Release v4.14.0
Low
12/5/2025
v4.13.0
Release v4.13.0
Low
12/5/2025
v4.11.8
Release v4.11.8
Low
12/3/2025
v4.11.6
## v4.11.6 (2025-12-03) _This release is published under the MIT License._ ### Bug Fixes - Create GitHub release from build-binary workflow (#254) ([#254](https://github.com/homeassistant-ai/ha-mcp/pull/254), [`8939c80`](https://github.com/homeassistant-ai/ha-mcp/commit/8939c807af84978d10d9665bdb6c5382b4bbcf67)) ### Chores - **addon**: Sync changelog for Home Assistant add-on [skip ci] ([`a502d87`](https://github.com/homeassistant-ai/ha-mcp/commit/a502d87fc232938ed67a3a5f003be17c23272ffa))
Low
12/3/2025
v4.11.5
## v4.11.5 (2025-12-03) _This release is published under the MIT License._ ### Bug Fixes - Use gh release upload to avoid target_commitish conflict (#252) ([#252](https://github.com/homeassistant-ai/ha-mcp/pull/252), [`e62e05b`](https://github.com/homeassistant-ai/ha-mcp/commit/e62e05ba3911f99a1dfbff7ef6783d86fc30e18b)) ### Chores - **addon**: Sync changelog for Home Assistant add-on [skip ci] ([`9e4ad12`](https://github.com/homeassistant-ai/ha-mcp/commit/9e4ad128a0feffdd8cbbaf6cf7562abdc5c
Low
12/3/2025
v4.11.4
## v4.11.4 (2025-12-03) _This release is published under the MIT License._ ### Bug Fixes - Trigger binary builds after SemVer Release via workflow_run (#249) ([#249](https://github.com/homeassistant-ai/ha-mcp/pull/249), [`a06ec57`](https://github.com/homeassistant-ai/ha-mcp/commit/a06ec57f3c11e4e740ba427945fd20244df74a61)) ### Chores - **addon**: Sync changelog for Home Assistant add-on [skip ci] ([`217afba`](https://github.com/homeassistant-ai/ha-mcp/commit/217afbaaeea041c5ff5ef8cb1563836e
Low
12/3/2025
Dependencies & License Audit
Loading dependencies...
Similar Packages
AI-Skills๐ค Enhance AI capabilities with modular Skills that provide expert knowledge, workflows, and integrations for any project.main@2026-06-07
telegram-mcp๐ค Manage multiple Telegram accounts effortlessly with AI-driven tools for bulk messaging, scheduling, and more in one easy-to-use platform.main@2026-06-07
Enterprise-Multi-AI-Agent-Systems-๐ค Build and deploy scalable Multi-AI Agent systems with LangGraph and Groq LLMs to enhance intelligence across enterprise applications.main@2026-06-07
AIDomesticCoreAIJ๐ ๏ธ Build a robust AI Kernel for stable, auditable, and sovereign AI systems, ensuring secure execution and compliance across various domains.main@2026-06-07
argus-mcp๐ Enhance code quality with Argus MCP, an AI-driven code review server using a Zero-Trust model for safe and efficient development.main@2026-06-07
More in MCP Servers
PlanExeCreate a plan from a description in minutes
agentroveYour own Claude Code UI, sandbox, in-browser VS Code, terminal, multi-provider support (Anthropic, OpenAI, GitHub Copilot, OpenRouter), custom skills, and MCP servers.
ProxmoxMCP-PlusEnhanced Proxmox MCP server with advanced virtualization management and full OpenAPI integration.
node9-proxyThe Execution Security Layer for the Agentic Era. Providing deterministic "Sudo" governance and audit logs for autonomous AI agents.