📌Overview

Purpose: To enable integration with Home Assistant using the Model Context Protocol for enhanced functionality and automation.

Overview: The mcp-server-home-assistant serves as a Model Context Protocol Server for Home Assistant, facilitating the interaction between the Home Assistant platform and other applications. This custom component streamlines communication and enhances the overall efficiency of smart home operations.

Key Features:

• Integration with Home Assistant: Seamlessly connects with Home Assistant, allowing users to leverage the capabilities of the Model Context Protocol for better home automation experiences.

• Custom Component Installation: Simplifies setup by providing clear instructions for the installation of the necessary custom component, ensuring users can easily integrate the protocol into their environment.

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 a pending pull request.

Usage in Claude Desktop

1. Install the home-assistant-model-context-protocol custom component in your Home Assistant instance.

2. Create a Long Lived Access Token in your Home Assistant profile.

3. Clone this git repo to a path like /Users/allen/Development/mcp-server-home-assistant.

4. Edit your claude_desktop_config.json with your Home Assistant URL and API token, for example:

   {
       "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....."
               }
           }
       }
   }
   

5. View logs (e.g. ~Library/Logs/Claude/mcp-server-Home-assistant.log) to understand what is happening.