mcp-server-home-assistant

A Model Context Protocol Server for Home Assistant, adhering to the Model Context Protocol specification.

The custom component required by this integration is being integrated into Home Assistant Core in https://github.com/home-assistant/core/pull/134122

Usage in Claude Desktop

1. Install the home-assistant-model-context-protocol custom component in your Home Assistant instance.
2. Generate a Long Lived Access Token from your Home Assistant profile.
3. Clone this git repository to a local path, such as /Users/allen/Development/mcp-server-home-assistant.
4. Configure your claude_desktop_config.json file, adding a "Home-assistant" entry under "mcpServers". This entry should specify the command to execute the server (using uv), the path to the cloned repository, and arguments for running mcp-server-home-assistant with verbose logging (-v -v). The environment variables HOME_ASSISTANT_WEB_SOCKET_URL (e.g., "http://localhost:8123/api/websocket") and HOME_ASSISTANT_API_TOKEN must be set with your Home Assistant URL and API token, respectively.
5. Monitor the logs at ~Library/Logs/Claude/mcp-server-Home-assistant.log for debugging and operational insights.