Index / Homelab

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.
Repositoryhttps://github.com/homeassistant-ai/ha-mcp
CategoryHomelab
Systems touchedHome 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 / priceMIT / free
GitHub stars7756 (checked Oct 2026)
Read toolssearch/overview, entity and device state, history and automation traces, dashboard/config reads (ha_call_read_tool proxy for readOnlyHint tools)
Write / delete / exec toolsdevice 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 modeYes: 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 notesNeeds 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.
Verifiedyes (README + config source review 2026-11-14)
NotesCommunity (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.