hass-mcp

Ein Open-Source MCP-Server zur Steuerung und Abfrage von Home Assistant.

• Transport: stdio

• Authentifizierung: Home Assistant Long-Lived Token

• API: Home Assistant REST-API

Funktionen

Bereitgestellte Tools:

• ha_get_state — Zustand einer Entität abrufen

• ha_list_states — Alle Zustände auflisten (kann umfangreich sein)

• ha_call_service — Einen beliebigen Dienst aufrufen

Installation

pnpm install
pnpm build

Ausführung

export HASS_URL="http://homeassistant.local:8123"
export HASS_TOKEN="<your long-lived access token>"

pnpm start

Konfiguration in einem MCP-Client

Beispiel (konzeptionell):

{
  "mcpServers": {
    "homeassistant": {
      "command": "npx",
      "args": ["-y", "hass-mcp"],
      "env": {
        "HASS_URL": "http://homeassistant.local:8123",
        "HASS_TOKEN": "..."
      }
    }
  }
}

Sicherheit

• Behandle Token als Geheimnisse.

• Bevorzuge den Betrieb dieses Servers im selben LAN wie Home Assistant.

• Wenn sich dein HA hinter Cloudflare Access befindet, betreibe diesen MCP-Server auf der LAN-Seite.

Lizenz

MIT