homeassistant-ai/ha-mcp

Install the HA-MCP Custom Component via HACS (recommended; runs the server in-process)
uvx ha-mcp@latest   (PyPI streamable-HTTP)
Docker: ghcr.io/homeassistant-ai/ha-mcp   (HTTP mode)

Usage

• •Recommended: add the HA-MCP Custom Component via HACS, restart, add the HA-MCP Server integration, then paste the webhook URL into your AI client
• •Or run as a Home Assistant add-on / Docker / uvx and point the client at the server URL
• •Ask e.g. "Create an automation that turns on the porch light at sunset" or "The motion sensor automation isn't working, debug it"

Key features

• ✓87 tools: search, control (any service, bulk), manage (automations/scripts/dashboards/areas/zones/helpers), monitor (history, stats, camera snapshots, automation traces), system (backups, updates, add-ons, device/entity registry)
• ✓Search-based tool discovery (BM25) for smaller/local LLMs without deferred tool loading
• ✓Bundled skills served as MCP resources via skill:// URIs
• ✓Safety: Read Only Mode, per-tool enable/disable, tool security policies (user approval), automatic edit backups
• ✓OIDC authentication option for remote access; OpenAI Tunnel option for firewalled ChatGPT setups

Caveats

• ⚠stdio transport has known connection issues — HTTP or the custom component is recommended
• ⚠Configure exactly one install method per client; duplicate entries are a known cause of connection hangs
• ⚠File & YAML tools require the custom component plus beta feature flags (ha_config_set_yaml moved to beta in v7.3.0)
• ⚠Runs locally; client toollists must be refreshed after changing server settings