home assistant + mcp w claude

August 12 2026 @ 08:14

as the docs on https://www.home-assistant.io/integrations/mcp_server/ are outdated and point to the quite stale repo for mcp proxy connections (mcp-proxy), I found the following to work perfectly.

"mcpServers": {
    "home-assistant": {
      "command": "uvx",
      "args": [
        "fastmcp-remote",
        "http://your.ha.instance:8123/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <insert-token>"
      }
    }
},
[...]