ha-config-mcp

CLI & MCP server for Home Assistant configuration management via WebSocket API.

Manage integrations, config flows, and Lovelace dashboards without touching the HA web UI.

Note: This project is fully developed and maintained by Claude (Anthropic). Don't expect it to work out of the box, though it probably will.

Install

# Nix (recommended)
nix run github:aster-void/ha-config-mcp -- --help
nix profile install github:aster-void/ha-config-mcp

# uvx / pipx
uvx ha-config-mcp --help
pipx install ha-config-mcp

Authentication

Set a Long-Lived Access Token:

export HA_TOKEN="your-token"
# Or place it in ~/.config/ha-assist-token

CLI Usage

# List integrations
ha-config entries list
ha-config entries list -d music_assistant

# Add a new integration (interactive config flow)
ha-config flow start hue
# → returns flow_id and data_schema
ha-config flow step <flow_id> '{"host": "192.168.1.100"}'

# Edit an existing integration's settings
ha-config options start <entry_id>
ha-config options step <flow_id> '{"option": "value"}'

# Delete an integration
ha-config entries delete <entry_id>

# Lovelace dashboards
ha-config lovelace list
ha-config lovelace get
ha-config lovelace get my-dashboard
ha-config lovelace save dashboard.yaml my-dashboard

Output is YAML by default. Use --json for JSON output.

MCP Server

# Start MCP server (stdio)
ha-config mcp

# Add to Claude Code
claude mcp add ha-config -- ha-config mcp
# or with nix
claude mcp add ha-config -- nix run github:aster-void/ha-config-mcp -- mcp

MCP Tools

Environment Variables

License

MIT