Hass-MCP is a Model Context Protocol server that integrates Home Assistant with AI assistants like Claude, enabling them to query, control, and summarize smart home devices and automations.
A Model Context Protocol (MCP) server designed to integrate Home Assistant with AI assistants like Claude, enabling them to interact with your smart home.
Hass-MCP empowers AI assistants to query device states, control entities (lights, switches), provide summaries, troubleshoot automations, search for entities, and create guided conversations for common tasks.
Key features include entity management (state retrieval, control, search), domain summaries, automation support (listing, control), guided conversations using prompts, smart search, and token-efficient JSON responses.
Requires a Home Assistant instance with a Long-Lived Access Token and either Docker (recommended) or Python 3.13+ with uv.
Docker installation is recommended. Configuration involves pulling the Docker image and adding an MCP server configuration to Claude Desktop's claude_desktop_config.json, specifying the Docker command and environment variables for HA_URL and HA_TOKEN.
Examples include querying device states, controlling entities, listing sensors, summarizing domains, creating automations, and troubleshooting.