Provides a Model Context Protocol Server for Home Assistant, allowing Claude to interact with Home Assistant through the MCP protocol. Requires a Home Assistant instance with a long-lived access token.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Home Assistant MCPturn off the living room lights"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-home-assistant
A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.
The custom component required by this integration is moving to Home Assistant Core in https://github.com/home-assistant/core/pull/134122
Usage in Claude Desktop
Install the home-assistant-model-context-protocol custom component in your Home Assistant instance
Create a Long Lived Access Token
Clone this git repo to a path like
/Users/allen/Development/mcp-server-home-assistantEdit your
claude_desktop_config.jsonwith something like this and include your home assistant url and api token:{ "mcpServers": { "Home-assistant": { "command": "uv", "args": [ "--directory", "/Users/allen/Development/mcp-server-home-assistant", "run", "mcp-server-home-assistant", "-v", "-v" ], "env": { "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket", "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9..... } } } }You can view the logs e.g.
~Library/Logs/Claude/mcp-server-Home-assistant.logto understand what is happening
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.