ha-mcp (Home Assistant)
access level: write✔ Source-reviewed Oct 2026
We read this project's source code and tool definitions (Oct 2026). This is a code review, not a live test against real systems. Re-check after upgrades.
| Repository | https://github.com/homeassistant-ai/ha-mcp |
|---|---|
| Category | Homelab |
| Systems touched | Home Assistant: entities and devices, automations, scripts, dashboards, helpers, backups, updates, add-ons, files/YAML (beta) |
| Access (as described) | write (Read Only Mode off by default) |
| License / price | MIT / free |
| GitHub stars | 7756 |
| Read tools | search/overview, entity and device state, history and automation traces, dashboard/config reads (ha_call_read_tool proxy for readOnlyHint tools) |
| Write / delete / exec tools | device control, create/edit/delete automations, scripts, dashboards and helpers; ha_manage_backup, ha_manage_updates, ha_restart, ha_reload_core; beta file/YAML tools incl. ha_write_file, ha_delete_file, ha_config_set_yaml (behind feature flags) |
| Read-only mode | Yes: READ_ONLY_MODE toggle (default false), per-tool enable/disable, per-tool security policies needing user approval; tool-search mode splits read/write/delete proxies so clients can auto-approve reads only |
| Safety notes | Needs an administrator token. Use a dedicated local-only admin account rather than your own long-lived token (a leaked personal token works from anywhere). Turn on Read Only Mode until you trust it; keep the beta file/YAML flags off. Remote access starts disabled — keep it that way unless needed. |
| Verified | yes (README + config source review 2026-11-14) |
| Notes | Community (unofficial) server, 86-87 tools. Now in the built-in Home Assistant Marketplace from HA 2026.11 (reported 2026-11-11); earlier versions install via HACS. Runs in-process as an integration, as an add-on, Docker or stdio. Added 2026-11-14. |
📬 SysAdmin Agents
The SysAdmin Agents newsletter: new MCP servers, agent skills and safety notes for sysadmins. One email a week.