MCP Server Home Assistant

🚀 mcp-server-home-assistant

A Model Context Protocol server designed for Home Assistant. For background information, visit Model Context Protocol.

The custom component required for this integration is being migrated to Home Assistant Core. See here for details.

🚀 Quick Start

✨ Features

This project serves as a Model Context Protocol server for Home Assistant, enabling seamless integration and interaction within the Home Assistant ecosystem.

📦 Installation

The custom component required for this integration is in the process of being migrated to Home Assistant Core. You can track the progress here.

💻 Usage Examples

Basic Usage

To use this in Claude Desktop, follow these steps:

1. Install the home-assistant-model-context-protocol custom component in your Home Assistant instance.
2. Create a long-lived access token.
3. Clone this Git repository to a path like /Users/allen/Development/mcp-server-home-assistant.
4. Edit your claude_desktop_config.json file and add the following content, including 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....."
            }
        }
    }
}

5. You can view the logs, such as ~Library/Logs/Claude/mcp-server-Home-assistant.log, to understand what's happening.