Home Assistant MCP mit Claude verbinden

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

Home Assistant + Claude

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: Geräte werden nie gesteuert. Funktioniert mit self-hosted Home Assistant.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

HOME_ASSISTANT_URL, HOME_ASSISTANT_TOKEN

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst eine Home-Assistant-Instanz, die AnythingMCP erreichen kann, und ein langlebiges Zugriffstoken, idealerweise von einem eigenen 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 eigenen Home-Assistant-Benutzer für AnythingMCP an, bei dem Administrator ausgeschaltet ist. Keiner der Endpunkte, die der Connector nutzt, braucht 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: Das Tool 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) samt Attributen, der aufgezeichnete Verlauf von Werten über einen Zeitraum, das Logbuch darüber, was wann passiert ist (zum Beispiel wann sich das Garagentor zuletzt geöffnet hat), deine Kalender und deren 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 nur Lesezugriffe bereitstellt, und nicht aus dem Token.

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

Datenschutz: Smart-Home-Daten zeigen, wer zu Hause ist, und verraten die täglichen Routinen des Haushalts. Weise den Connector nur MCP-Servern zu, deren Nutzer 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 zurück, 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 deren Kalendertermine 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 an und liest weder den Event-Stream noch das Fehlerprotokoll oder die WebSocket-API (Bereiche, Geräte, Entity-Registry).

Schritt 2 — Den Adapter 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

Schritt 3 — Den Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere dessen URL (https://cloud.anythingmcp.com/mcp/…). Verwende sie überall dort, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg — funktioniert im claude.ai-Web ohne Bearbeiten einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. Home Assistant, sowie die URL des Remote-MCP-Servers https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID und klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten aufgeführten Tools erscheinen in deinem Chat — du kannst direkt mit deinen Prompts loslegen.

Verfügbare Tools

FAQ

Funktioniert es auch mit Claude Code und Claude Desktop? Ja — richte beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID aus.

Nächste Schritte

• Connector-Landingpage
• Mit ChatGPT verbinden