Allenporter MCP Server Home Assistant

Exposes Home Assistant data and actions as an MCP endpoint for client integrations.

other

GitHub Stars

other

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-allenporter_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_API_TOKEN": "YOUR_TOKEN_HERE",
        "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket"
      }
    }
  }
}

You can run a Home Assistant Model Context Protocol (MCP) server locally to connect Home Assistant data and actions with MCP clients. This server lets you expose a Home Assistant instance as an MCP endpoint, enabling practical automation and context-sharing with Claude Desktop clients or other MCP-enabled tools.

How to use

To use this MCP server with your MCP client, configure a local MCP server entry that points to your Home Assistant instance. You will provide the Home Assistant WebSocket URL and an API token in the environment, and start the MCP server so your client can connect and request context from Home Assistant.

How to install

Prerequisites: you need a machine capable of running the MCP server binaries and access to your Home Assistant instance. You also need a way to run the MCP server command shown below.

Clone the MCP server repository to your desired path.
Edit your Claude/Claude Desktop configuration to include the Home Assistant MCP server as shown in the code block.
Start the MCP server using the exact command and arguments provided in the configuration snippet.

Additional notes

Configuration shown below is an MCP stdio server configuration using uv to run a local MCP server from a directory. Ensure you replace placeholder values with your actual Home Assistant details and keep the path to your local server correct.

{
  "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": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Start and logs

After you configure the server, start it via the MCP launcher you use in Claude Desktop. You can monitor runtime logs to verify it connects to Home Assistant. Logs can typically be found at the path where you cloned the repository, or as configured by your MCP client app.

Built by

VeilStrat

AI signals for GTM teams