Overview
Hass-MCP is a Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs. It enables AI assistants to interact directly with your Home Assistant instance, allowing them to query device and sensor states, control lights and other entities, obtain summaries of your smart home, troubleshoot automations and entities, search for specific entities, and engage in guided conversations for common tasks. The server exposes a suite of MCP tools (e.g., get_version, get_entity, entity_action, list_entities, search_entities_tool, domain_summary_tool, list_automations, call_service_tool, restart_ha, get_history, get_error_log) to perform common Home Assistant operations with lean, token-efficient responses. Prerequisites include a Home Assistant instance with a Long-Lived Access Token, and a Docker-ready user experience (Docker recommended) or runtime options like uv/uvx. Installation examples show pulling the Docker image (docker pull voska/hass-mcp:latest) and configuring Claude Desktop or Cursor for easy access. The README also provides usage prompts and examples to guide setups and workflows.
Features
Entity Management
Get states, control devices, and search for entities
Domain Summaries
Get high-level information about entity types
Automation Support
List and control automations
Guided Conversations
Use prompts for common tasks like creating automations
Smart Search
Find entities by name, type, or state
Token Efficiency
Lean JSON responses to minimize token usage




