homeassistant-mcp

01 · What it does

• Device Control: Control any Home Assistant device through natural language
• Real-time Updates: Get instant updates through Server-Sent Events (SSE)
• Automation Management: Create, update, and manage automations
• State Monitoring: Track and query device states
• Secure: Token-based authentication and rate limiting

02 · Install

$ git clone https://github.com/tevonsb/homeassistant-mcp.git
$ docker compose up -d
$ docker compose up -d --build

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

{
  "homeassistant": {
    "command": "node",
    "args": [<path/to/your/dist/folder>]
    "env": {
      NODE_ENV=development
      HASS_HOST=http://homeassistant.local:8123
      HASS_TOKEN=your_home_assistant_token
      PORT=3000
      HASS_SOCKET_URL=ws://homeassistant.local:8123/api/websocket
      LOG_LEVEL=debug
    }
  }
}

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