# ha-mcp

> The Unofficial and Awesome Home Assistant MCP Server

- **URL**: https://www.freshcrate.ai/projects/ha-mcp
- **Author**: homeassistant-ai
- **Category**: MCP Servers
- **Latest version**: `v7.6.0` (2026-05-27)
- **License**: MIT
- **Source**: https://github.com/homeassistant-ai/ha-mcp
- **Language**: Python
- **GitHub**: 2,465 stars, 91 forks
- **Registry**: github
- **Tags**: `python`

## Description

The Unofficial and Awesome Home Assistant MCP Server

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v7.6.0` | 2026-05-27 | High | ### Added  - Make HTTP bind host configurable via MCP_HOST (closes #1434)   ([#1436](https://github.com/homeassistant-ai/ha-mcp/pull/1436)) - Tool Security Policies — per-tool approval gating (#966)   ([#1421](https://github.com/homeassistant-ai/ha-mcp/pull/1421)) - Rename ha_delete_helpers_integrations → ha_remove_helpers_integrations + raise on missing target   ([#1424](https://github.com/homeassistant-ai/ha-mcp/pull/1424)) - Auto-backup edited entities before write/destructive tool calls (cl |
| `v7.5.0` | 2026-05-13 | High | ### 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 |
| `v7.4.1` | 2026-05-02 | High | ## 🚨 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 |
| `v7.4.0` | 2026-04-29 | High | ### 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_ |
| `v7.3.0.dev386` | 2026-04-20 | High | ## 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 ``` |
| `v7.3.0.dev385` | 2026-04-20 | High | ## 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 ``` |
| `v7.3.0.dev384` | 2026-04-19 | High | ## 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 ``` |
| `v7.3.0.dev383` | 2026-04-19 | High | ## 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 ``` |
| `v7.3.0.dev382` | 2026-04-18 | High | ## 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 ``` |
| `v7.3.0` | 2026-04-15 | High | ### 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 |

## Citation

- HTML: https://www.freshcrate.ai/projects/ha-mcp
- Markdown: https://www.freshcrate.ai/projects/ha-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ha-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._