Hass-MCP
by voska
Hass-MCP is a Model Context Protocol (MCP) server designed for Home Assistant integration with Claude and other LLMs. It allows AI assistants to interact directly with your Home Assistant instance.
Last updated: N/A
What is Hass-MCP?
Hass-MCP is a server that enables AI assistants like Claude to interact with your Home Assistant instance. It acts as a bridge, allowing the AI to query states, control devices, get summaries, troubleshoot issues, search for entities, and create guided conversations for common smart home tasks.
How to use Hass-MCP?
To use Hass-MCP, you need a Home Assistant instance with a Long-Lived Access Token. You can install it using Docker (recommended) or Python. After installation, configure your MCP client (e.g., Claude Desktop, Cursor, or Claude Code CLI) to connect to the Hass-MCP server, providing the Home Assistant URL and token. Once configured, you can use prompts with your AI assistant to interact with your smart home.
Key features of Hass-MCP
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
Use cases of Hass-MCP
Querying the state of devices and sensors
Controlling lights, switches, and other entities
Getting summaries of your smart home
Troubleshooting automations and entities
Searching for specific entities
Creating guided conversations for common tasks
FAQ from Hass-MCP
What is a Long-Lived Access Token?
What is a Long-Lived Access Token?
A Long-Lived Access Token is a persistent authentication token for Home Assistant, allowing applications like Hass-MCP to securely access your Home Assistant instance without requiring constant re-authentication.
Why use Docker for installation?
Why use Docker for installation?
Docker provides a containerized environment, simplifying installation and ensuring consistency across different systems. It also isolates Hass-MCP from other applications on your machine.
How do I update the HA_URL?
How do I update the HA_URL?
The HA_URL should point to the address of your Home Assistant instance. If running Home Assistant on the same machine as Hass-MCP, use http://host.docker.internal:8123 (Docker Desktop on Mac/Windows) or the machine's IP address. If running Home Assistant on another machine, use its IP or hostname.
What if I'm running Home Assistant in Docker?
What if I'm running Home Assistant in Docker?
If Home Assistant is in Docker, you might need to add --network host to the Docker args for Hass-MCP to access Home Assistant directly. Alternatively, use the IP address of your machine instead of host.docker.internal.
What if my automation isn't working?
What if my automation isn't working?
Use the debug_automation prompt to troubleshoot the automation. Hass-MCP can help diagnose issues with triggers, conditions, and actions.