Home Assistant MCP-Server: Sensoren und Verlauf

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Home Assistant, füge deine Zugangsdaten ein, erzeuge einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

Home Assistant

Lass deine KI dein Home Assistant lesen: den aktuellen Zustand jedes Sensors, Lichts, jeder Tür und jedes Thermostats, den aufgezeichneten Verlauf, das Logbuch darüber, was wann passiert ist, und deine Kalender. Nur lesend: Es steuert nie Geräte. Funktioniert mit self-hosted Home Assistant.

Einrichtung

Die Einrichtung dauert etwa 3 Minuten. Du brauchst eine Home-Assistant-Instanz, die AnythingMCP erreichen kann, und ein langlebiges Zugriffstoken, idealerweise von einem dedizierten Nicht-Admin-Benutzer.

1. Setze HOME_ASSISTANT_URL auf die Adresse, unter der du Home Assistant öffnest, ohne abschließenden Schrägstrich und ohne /api, zum Beispiel https://home.example.com oder http://192.168.1.10:8123 (der Standardport ist 8123).
2. Empfohlen: Lege unter Einstellungen → Personen → Benutzer → Benutzer hinzufügen einen dedizierten Home-Assistant-Benutzer für AnythingMCP an, mit deaktiviertem Administrator. Keiner der Endpunkte, die der Connector nutzt, benötigt Admin-Rechte.
3. Melde dich als dieser Benutzer an und klicke unten links auf deinen Namen, um dein Profil zu öffnen. Öffne den Tab Sicherheit und klicke unter Langlebige Zugriffstoken auf Token erstellen. Kopiere das Token (es wird nur einmal angezeigt und bleibt 10 Jahre gültig) und füge es in HOME_ASSISTANT_TOKEN ein, ohne das Wort Bearer.
4. Installiere den Connector und führe home_assistant_get_config aus: Es liefert Version, Standortname und Zeitzone zurück und bestätigt, dass Adresse und Token funktionieren.

Was gelesen wird: der aktuelle Zustand jeder Entität (Sensoren, Lichter, Klima, Türen, Anwesenheit) mit ihren Attributen, der aufgezeichnete Werteverlauf über einen Zeitraum, das Logbuch darüber, was wann passiert ist (zum Beispiel wann sich das Garagentor zuletzt geöffnet hat), deine Kalender und ihre Termine sowie die Instanzkonfiguration. Entity-IDs sehen so aus: sensor.living_room_temperature oder binary_sensor.garage_door.

Nur lesend: Jedes Tool ist eine GET-Anfrage. Der Connector kann keine Aktionen (Services) aufrufen, nichts ein- oder ausschalten, keine Türen entriegeln, keine Skripte ausführen und keine Zustände ändern. Der Aktions-Endpunkt von Home Assistant ist nicht auf Admins beschränkt, daher stammt diese Garantie daraus, dass der Connector ausschließlich Lesezugriffe bereitstellt, und nicht aus dem Token.

Wo Home Assistant läuft: Bei einem self-hosted AnythingMCP braucht eine Instanz in einem privaten Netzwerk (http://192.168.x.x:8123, homeassistant.local) einen Administrator, der den Host in SSRF_ALLOWED_HOSTS oder in der Allowlist in den Admin-Einstellungen freigibt. AnythingMCP Cloud kann nur eine Instanz erreichen, die über HTTPS im öffentlichen Internet erreichbar ist, zum Beispiel hinter einem Reverse Proxy oder über den Fernzugriff von Home Assistant Cloud.

Datenschutz: Smart-Home-Daten zeigen, wer zu Hause ist und wie der Alltag des Haushalts aussieht. Weise den Connector nur MCP-Servern zu, deren Benutzer diese Daten sehen dürfen.

Zeiten: Zeitstempel werden als ISO 8601 in UTC mit dem Suffix Z übergeben, zum Beispiel 2026-10-01T00:00:00Z. home_assistant_get_config liefert die Zeitzone des Zuhauses, damit du Ergebnisse passend darstellen kannst.

Häufige Fehler: 401 bedeutet, dass das Token falsch ist oder gelöscht wurde. 404 bei einer einzelnen Entität oder ihren Kalenderterminen bedeutet, dass keine Entität diese ID hat; 404 bei jedem Aufruf bedeutet, dass HOME_ASSISTANT_URL falsch ist oder bereits auf /api endet. 400 bei Kalenderterminen bedeutet, dass start oder end fehlt oder kein gültiger Zeitstempel ist. Eine abgelehnte oder blockierte Verbindung bedeutet, dass der Host nicht in der SSRF-Allowlist freigegeben ist (self-hosted) oder nicht öffentlich über HTTPS erreichbar ist (Cloud).

Der Connector ruft keine Aktionen oder Services auf, schreibt oder löscht keine Zustände, löst keine Events aus, rendert keine Templates, zeigt keine Kamerabilder und liest weder den Event-Stream noch das Fehlerprotokoll oder die WebSocket-API (Bereiche, Geräte, Entity Registry).

Voraussetzungen: HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Den Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Home Assistant und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden