ha-nexus-agent

01 · What it does

• 323 MCP tools across 29 categories: the most complete HA MCP server available
• Built-in tool search: discover_tool_search("query") finds the right tool without flooding the AI's context
• Automation linter: automations_validate_best_practices catches 7 common YAML mistakes before they cause issues
• Updates monitor: system_get_updates lists all pending updates across core, add-ons and HACS
• Repair issues: system_get_repairs surfaces active issues from HA's repair centre

02 · Install

$ git clone https://github.com/Fistacho/ha-nexus-agent
$ pip install -r requirements.txt
$ docker run -d --name nexus \
$ claude mcp add nexus --transport http "http://your-ha-ip:7123/mcp" --header "Authorization: Bearer YOUR_API_KEY" --scope user

03 · Client config (Claude Desktop / Cursor, from README)

{
  "servers": {
    "nexus": {
      "type": "http",
      "url": "http://your-ha-ip:7123/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Commands copied from the project README. Placeholders are the maintainer's. Not bench-tested by HardwareMCP yet.