selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Hass-MCP logo

Self-host Hass-MCP

v0.6.1

Bridge LLMs to Home Assistant via Model Context Protocol

ReleaseOpen SourceMIT
Updated4 days ago
LanguagePython
Setup difficultyModerate
Stars
351
Port
8000 (MCP streamable HTTP transport endpoint)
Requires
Home Assistant
Docker
voska/hass-mcp
Install with Docker
Hass-MCP in Claude Desktop showing entity controlHass-MCP dashboard editing interfaceHass-MCP automation troubleshooting

What is Hass-MCP?

Hass-MCP connects AI assistants such as Claude to a self-hosted Home Assistant instance through the Model Context Protocol. It exposes tools for querying entity states, controlling devices, searching entities, managing automations, reading error logs, retrieving long-term statistics, and live-editing Lovelace dashboards over WebSocket. The server runs via Docker or uvx, requires a Home Assistant long-lived access token, and supports both stdio and streamable HTTP transports. It is open-source under MIT license with no paid tiers.

Should you self-host Hass-MCP?

Hass-MCP scores 50/100 on selfhost.directory (how scoring works) and ranks #63 of 104 in Home Automation. It has 351 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v0.6.1, came out on 24 October 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 796 stars). It scores higher overall, so compare the two before you pick. See Hass-MCP vs Home Assistant side by side.

Features

  • Area-based Entity Listing
  • Automation Support
  • Custom CA Support
  • Domain Summaries
  • Entity Management
  • Error Log Filtering
  • Guided Conversations
  • Live Dashboard Editing
  • Long Term Statistics
  • MCP prompts
  • MCP resources
  • Smart Search
  • Streamable HTTP transport
  • Token Efficiency

Hass-MCP README

How to install Hass-MCP

Install Hass-MCP with Docker

Environment variables
HA_URL, HA_TOKEN

docker pull voska/hass-mcp:latest

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "http://homeassistant.local:8123",
        "HA_TOKEN": "YOUR_LONG_LIVED_TOKEN"
      }
    }
  }
}

Recommended installation method. Use --network host or host.docker.internal for local HA.

How to configure Hass-MCP

  • HASS_MCP_BACKUP_DIR~/.hass-mcp/dashboard-backups/Directory for dashboard config backups

    Directory for dashboard config backups

  • HA_TOKENHome Assistant long-lived access token

    Home Assistant long-lived access token

  • HA_URLhttp://homeassistant.local:8123Home Assistant instance URL

    Home Assistant instance URL

  • MCP_PORTAlternative port environment variable for HTTP transport

    Alternative port environment variable for HTTP transport

  • PORTPort for HTTP transport (Smithery convention)

    Port for HTTP transport (Smithery convention)

  • SSL_CERT_FILEPath to custom CA certificate for TLS verification

    Path to custom CA certificate for TLS verification

Hass-MCP releases & version history

More in Home Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…