MCP Server Home Assistant

1# mcp-server-home-assistant
2 
3A Model Context Protocol Server for Home Assistant. See [Model Context Protocol](https://modelcontextprotocol.io/)
4for context.
5 
6The custom component required by this integration is moving to Home Assistant Core in https://github.com/home-assistant/core/pull/134122
7 
8## Usage in Claude Desktop
9 
101. Install the [home-assistant-model-context-protocol](https://github.com/allenporter/home-assistant-model-context-protocol) custom component in your Home Assistant instance
111. Create a [Long Lived Access Token](https://www.home-assistant.io/docs/authentication/#your-account-profile)
121. Clone this git repo to a path like `/Users/allen/Development/mcp-server-home-assistant`
131. Edit your `claude_desktop_config.json` with something like this and include your home assistant url and api token:
14 
15    ```json
16    {
17        "mcpServers": {
18            "Home-assistant": {
19                "command": "uv",
20                "args": [
21                    "--directory",
22                    "/Users/allen/Development/mcp-server-home-assistant",
23                    "run",
24                    "mcp-server-home-assistant",
25                    "-v",
26                    "-v"
27                ],
28                "env": {
29                    "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
30                    "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9.....
31                }
32            }
33        }
34    }
35    ```
361. You can view the logs e.g. `~Library/Logs/Claude/mcp-server-Home-assistant.log` to understand what is happening
37