Back to Catalog

mcp-server-home-assistant

allenporter/mcp-server-home-assistant
🔗 Latest commit:0a82f5d
🕒 Updated:Sep 9, 2025, 01:06 PM
Python
IoT

A Model Context Protocol Server for Home Assistant

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score65/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:57
👥 Contributors:2
📋 Total Issues:5
📦 Has Releases:Yes
🔧 Has CI/CD Pipeline:Yes
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "mcp-server-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....."
    }
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:
Prompts:
Resources:
Sampling:
Roots:
Logging:
STDIO Transport:
HTTP Transport:
OAuth2 Auth:
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/allenporter/mcp-server-home-assistant)](https://archestra.ai/mcp-catalog/allenporter__mcp-server-home-assistant)
README.md

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

  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 repo to a path like /Users/allen/Development/mcp-server-home-assistant

  4. Edit your claude_desktop_config.json with 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.....
                }
            }
        }
    }
    
  5. You can view the logs e.g. ~Library/Logs/Claude/mcp-server-Home-assistant.log to understand what is happening

mcp-server-home-assistant MCP Server | Documentation & Integration | Archestra