Home Assistant MCP Server

What it does

Connects an AI agent directly to a Home Assistant instance via WebSockets. It allows the AI to act as a powerful diagnostic and management tool, capable of investigating why automations failed, checking system logs, and managing the smart home environment.

Tools

• list_entities, get_entity, get_history, get_logbook: Manage and query entity states and history.
• list_services, call_service: Execute any Home Assistant service.
• list_automations, list_traces, get_trace: Debug automation logic and execution flows.
• get_error_log, check_config, reload: System diagnostics and configuration management.
• read_config_file, write_config_file, list_config_dir: Direct filesystem access to HA config (via SSH).
• list_addons, get_addon_info, get_addon_log, restart_addon: Supervisor and add-on management.
• mqtt_dump_retained, mqtt_publish: MQTT broker interaction.
• list_dashboards, get_lovelace_config, save_lovelace_config, add_lovelace_cards: Lovelace dashboard manipulation.

Installation

{\n  "mcpServers": {\n    "home-assistant": {\n      "command": "uv",\n      "args": ["--directory", "/absolute/path/to-home-assistant-mcp", "run", "home-assistant-mcp"],\n      "env": {\n        "HA_URL": "http://homeassistant.local:8123",\n        "HA_TOKEN": "your-long-lived-access-token"\n      }\n    }\n  }\n}

Supported hosts

• Claude Desktop