Google Home MCP-Server

   Early Access   

Der Google Home MCP-Server (Model Context Protocol) ermöglicht es KI-basierten Entwicklungstools und virtuellen Assistenten, direkt mit Smart-Home-Umgebungen zu interagieren. Durch die Bereitstellung von Standard-MCP-Tools und RPC-Schnittstellen ermöglicht der Server Large Language Models (LLMs), Gebäude zu prüfen, Gerätestatus zu überwachen, Steuerungsaktionen auszuführen und historische Ereignisse zu analysieren.

Warnung!

Wenn Sie ein echtes Zuhause mit einem KI-Agenten verbinden, kann dieser Agent Geräte in Ihrem Namen steuern. Der Home-MCP erzwingt Ratenbegrenzungen und Sicherheitsmaßnahmen, z. B. das Verbot sensibler Aktionen wie das Entriegeln von Türen. Je nach Agent kann die Verbindung mit Home MCP jedoch zu unerwartetem oder sogar unerwünschtem Verhalten führen. Lesen Sie sich die Richtlinien für Entwickler und die Nutzungsbedingungen sorgfältig durch.

Wenn du ein Google Home-Gerät, das von anderen Mitgliedern des Haushalts verwendet wird, mit dem Home MCP verbindest, solltest du sie darüber informieren, dass dein KI-Agent Geräte steuern und auf Daten des Zuhauses zugreifen kann. Alternativ kannst du ein zusätzliches Zuhause erstellen und Geräte für die Entwicklung und das Testen einrichten.

Der Zugriff deines KI-Agenten auf den Home MCP kann jederzeit über die Google Home app (GHA) oder die Seite „Meine Konten“ widerrufen werden.

Übersicht

Ein MCP-Server fungiert als Proxy zwischen der Smart-Home-Infrastruktur und KI-Anwendungen. Der Home-MCP-Server stellt ausführbare Tools bereit, mit denen KI-Clients Echtzeit-Telemetriedaten des Zuhauses abfragen und Befehle senden können.

Hauptfunktionen

Der Home-MCP-Server bietet mehrere Kernfunktionen:

  • Gebäudeerkennung: Mit list_homes kannst du auf zugängliche Zuhause und Gebäude zugreifen.
  • Ressourcenermittlung: Mit list_home_resources kannst du Geräte, Bereichslayouts, Eigenschaften, Attribute und Befehlsschemas auflisten.
  • Statusüberwachung: Mit list_home_states kannst du den Echtzeit-Verbindungsstatus und die Attributstatus von Geräten prüfen.
  • Gerätesteuerung: Mit run_home_actions können Sie parametrisierte Aktionsbefehle auf Zielgeräten ausführen.
  • Verlaufsanalyse: Mit list_home_history können Sie vergangene Statusänderungen und Ereignisprotokolle für bestimmte Zeiträume abfragen.
  • Automatisierungen: Mit list_automations kannst du Automatisierungen auflisten und mit save_automation speichern.

Vorbereitung

Bevor Sie den Home-MCP-Server einrichten, benötigen Sie Folgendes:

  • Ein aktives Smart-Home-Setup in Google Home mit verbundenen Geräten.
  • Ein aktives Google Home Premium Advanced-Abo.
  • Zugriff auf ein Google Cloud-Projekt.
  • Ein MCP-kompatibler KI-Client oder eine MCP-kompatible KI-Anwendung wie Google Antigravity, Claude Cowork oder OpenClaw.

MCP-Server konfigurieren

Zum Einrichten des MCP-Servers müssen Sie ein Google Cloud-Projekt erstellen, eine Zugriffsgenehmigung einholen, die Home API aktivieren und OAuth-Anmeldedaten generieren.

Google Cloud-Projekt erstellen

Wenn Sie noch kein Google Cloud haben, müssen Sie eines erstellen:

  1. Öffnen Sie die Google Cloud-Konsole.
  2. Erstellen Sie ein neues Google Cloud-Projekt.

Weitere Informationen finden Sie im Artikel Projekte erstellen in der Google Cloud-Dokumentation.

Home API aktivieren

  1. Wählen Sie im Navigationsmenü der Google Cloud Console APIs und Dienste > Aktivierte APIs und Dienste aus.
  2. Suchen Sie nach Home API und klicken Sie auf Aktivieren.
  1. Konfigurieren Sie den OAuth-Zustimmungsbildschirm:
    1. Öffnen Sie APIs und Dienste > OAuth-Zustimmungsbildschirm.
    2. Wählen Sie die Zielgruppe Extern aus, klicken Sie auf Jetzt starten und geben Sie die erforderlichen App-Informationen und die Kontakt-E-Mail-Adresse ein.
  2. OAuth-Client-ID erstellen:
    1. Öffnen Sie APIs und Dienste > Anmeldedaten.
    2. Klicken Sie auf + Anmeldedaten erstellen und wählen Sie OAuth-Client-ID aus.
    3. Setzen Sie den Anwendungstyp auf Webanwendung.
    4. Fügen Sie die autorisierten Weiterleitungs-URIs für Ihre Ziel-KI-Clients hinzu:
      • Google Antigravity: https://antigravity.google/oauth-callback
      • Claude Cowork: https://claude.ai/api/mcp/auth_callback
      • OpenClaw: ein angepinnter Loopback-URI, der mit mcp-remote übereinstimmt, z. B. http://127.0.0.1:8989/oauth/callback
    5. Klicken Sie auf Erstellen und kopieren Sie die Client-ID und den Clientschlüssel an einen sicheren Ort.
  3. Veröffentlichen Sie Ihre Anwendung:
    1. Öffnen Sie die Google Auth Platform > Zielgruppe.
    2. Klicken Sie unter Veröffentlichungsstatus auf App veröffentlichen.

KI-Client konfigurieren

Sie können mehrere KI-Entwicklungsumgebungen so konfigurieren, dass sie über die OAuth-Authentifizierung eine Verbindung zum Home-MCP-Server herstellen. Geben Sie hier Ihre OAuth-Client-ID und Ihren Clientschlüssel ein und folgen Sie dann der gewünschten Einrichtungsanleitung.

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

Automatische Einrichtung über einen Prompt

Wenn Ihr KI-Assistent die Verwaltung von MCP-Toolkonfigurationen direkt im Chat unterstützt, können Sie ihn anweisen, den Server zu konfigurieren, indem Sie den folgenden Prompt einfügen:

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://home.googleapis.com/mcp
- Transport: streamable-http
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

Manuelle Einrichtung

Wählen Sie Ihr bevorzugtes KI-Tool aus, um eine Anleitung für die manuelle Einrichtung zu erhalten.

Antigravity

Google Antigravity bietet eine integrierte Einbindung für MCP-Server in der Befehlszeile, der IDE und der Desktop-Umgebung.

  1. Öffnen Sie das Konfigurationsmenü der Anwendung: Einstellungen > Erweiterte Einstellungen > Anpassungen > MCP-Konfiguration öffnen.
  2. Fügen Sie den Eintrag home_mcp unter dem Konfigurationsobjekt mcpServers hinzu:

    {
      "mcpServers": {
        "home_mcp": {
          "serverUrl": "https://home.googleapis.com/mcp",
          "oauth": {
            "clientId": "YOUR_CLIENT_ID",
            "clientSecret": "YOUR_CLIENT_SECRET"
          }
        }
      }
    }
    
  3. Authentifizierung abschließen: Gehen Sie zu Einstellungen > Erweiterte Einstellungen > Anpassungen > home_mcp > Authentifizierung.

  4. Schließe den Ablauf für die Google Home-Berechtigungen in deinem Webbrowser ab, wähle dein Zuhause aus und kopiere den Autorisierungscode zurück in Antigravity.

Weitere Informationen finden Sie in der Dokumentation zu Google Antigravity.

Claude

Konfigurieren Sie Claude Cowork so, dass eine Verbindung zu Ihrem benutzerdefinierten Home-MCP-Server hergestellt wird:

  1. Öffnen Sie Claude Connectors.
  2. Klicken Sie auf + und wählen Sie Benutzerdefinierten Connector hinzufügen aus.
  3. Geben Sie die Server-URL ein: https://home.googleapis.com/mcp.
  4. Klicken Sie auf Erweiterte Einstellungen und geben Sie Ihre Client-ID und Ihren Clientschlüssel ein.
  5. Klicken Sie auf Hinzufügen und schließen Sie den OAuth-Autorisierungsvorgang in Ihrem Browser ab.
  6. Klicken Sie in einem Cowork-Chat links unten auf +, wählen Sie Connectors aus und aktivieren Sie home_mcp.

Weitere Informationen finden Sie in der Dokumentation zur Claude-Plattform.

OpenClaw

OpenClaw unterstützt keinen nativen statischen OAuth-Client. Derzeit können Sie stdio über mcp-remote mit Streamable HTTP verbinden.

  1. Erstellen Sie eine lokale JSON-Datei mit dem Namen ~/.openclaw/home-mcp-client.json, die Ihre Google Cloud OAuth-Anmeldedaten enthält, damit sie nicht direkt in der Befehlszeile übergeben werden.

    {
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET"
    }
    
  2. Schränken Sie die Berechtigungen für diese Datei ein, sodass nur Ihr lokales Konto sie lesen kann:

    chmod 600 ~/.openclaw/home-mcp-client.json
    
  3. Registrieren Sie den Server in OpenClaw mit mcp-remote. Ersetzen Sie /absolute/path/to durch den vollständigen Pfad zu Ihrem Verzeichnis mit den Anmeldedaten (mcp-remote erweitert ~ nicht). Das Flag --transport http-only erzwingt Streamable HTTP, --host 127.0.0.1 entspricht dem registrierten Weiterleitungs-URI und --authorize-param fordert ein Aktualisierungstoken an:

    openclaw mcp set home_mcp '{
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://home.googleapis.com/mcp",
        "8989",
        "--host", "127.0.0.1",
        "--transport", "http-only",
        "--authorize-param", "access_type=offline",
        "--authorize-param", "prompt=consent",
        "--static-oauth-client-info",
          "@/absolute/path/to/home-mcp-client.json"
      ]
    }'
    
  4. Starten Sie das OpenClaw-Gateway neu:

    openclaw gateway restart
    
  5. Führen Sie openclaw mcp probe home_mcp aus, um die Anmeldung im Browser abzuschließen und die Toolerkennung zu prüfen.

Weitere Informationen finden Sie in der OpenClaw-Dokumentation.

Damit Nutzer auf Daten zur Gesichtswiedererkennung im Home MCP zugreifen können, müssen sie dieser Funktion ausdrücklich zustimmen.

Vorbereitung

  • Der Nutzer, der die Einwilligung erteilt, muss ein Manager des Gebäudes Google Home sein.
  • Das Gebäude des Nutzers muss mindestens eine kompatible Google Nest-Kamera oder ‑Türklingel und ein aktives Google Home Premium-Abo haben, bei dem die Gesichtswiedererkennung für jede Kamera oder Türklingel aktiviert ist.
  • Ihre Anwendung muss eine OAuth 2.0-Client-ID haben, die in Google Cloud erstellt wurde. Informationen zum Erstellen eines OAuth 2.0-Clients finden Sie unter KI-Client konfigurieren, falls Sie das noch nicht getan haben.

Damit deine Anwendung Zugriff erhält, musst du einen Zustimmungslink aufrufen, der mit deiner OAuth 2.0-Client-ID und der Gebäude-ID von Home personalisiert ist. Es gibt zwei Möglichkeiten, den Einwilligungslink abzurufen.

Rufen Sie den Link auf und geben Sie Ihre Einwilligung.

Wenn Ihr Agent bereits mit dem Home-MCP verbunden ist, kann er automatisch Ihre Home-Gebäude-ID finden und einen klickbaren Link generieren.

Aktualisieren Sie die folgenden Parameter direkt auf dieser Seite und kopieren Sie dann den angepassten Prompt in den Chat Ihres KI-Agenten.

  • CLIENT_ID: Ihre OAuth 2.0-Client-ID aus Google Cloud. Beispiel: `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: Der Name der Home-Zielstruktur.
Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

Wenn Ihr Agent bereits mit dem Home-MCP verbunden ist, kann er automatisch Ihre Home-Gebäude-ID finden und einen klickbaren Link generieren.

Aktualisieren Sie die folgenden Parameter direkt auf dieser Seite und öffnen Sie dann den angepassten Link in einem Webbrowser.

  • CLIENT_ID: Ihre OAuth 2.0-Client-ID aus Google Cloud. Beispiel: `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID: Die UUID der Zielstruktur Home. Am einfachsten erhältst du diese, indem du deinen Agenten über den Home MCP fragst: „Nenne mir die Gebäude-ID (UUID) für [Gebäudename].“
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Verbindung und Funktionalität prüfen

Nachdem der Client konfiguriert und authentifiziert wurde, prüfen Sie die Serververbindung:

  1. Starten Sie Ihren KI-Assistenten oder Ihre Workspace-Sitzung.
  2. Prüfen Sie die aktiven MCP-Serververbindungen (führen Sie in Antigravity /mcp aus oder prüfen Sie die Toollisten).
  3. Prüfen Sie, ob home_mcp mit aktiven Tools aufgeführt ist.
  4. Geben Sie Ihrem Assistenten Beispiel-Prompts, um verschiedene Funktionen zu testen:

    • Entitätserkennung: How many lights do I have in my house?
    • Echtzeit-Statusüberwachung: Is my home secured?
    • Gerätesteuerung: Turn off all the outside lights.
    • Analyse historischer Ereignisse: What happened while I was out?
  5. Erteilen Sie Berechtigungen zur Ausführung von Tools, wenn Sie von Ihrem Client dazu aufgefordert werden. Der KI-Assistent kann Echtzeit-Statusdaten abrufen und alle Antworten basieren auf den Telemetriedaten deines Zuhauses.

MCP-App für den privaten Gebrauch veröffentlichen

Wenn Sie eine eigene Website-URL, eine Datenschutzerklärung und Nutzungsbedingungen haben, können Sie den Abschnitt „Branding“ ausfüllen und die App dann in der Produktion veröffentlichen.

Andernfalls können Sie die App als Behelfslösung im Testmodus ausführen. Füllen Sie dazu den Abschnitt „Branding“ aus und verwenden Sie Ihr eigenes Google-Konto oder die Google-Konten anderer Mitglieder als Testnutzer.

Support

Wenn du Unterstützung bei der Entwicklung von Home MCP benötigst, besuche das Smart Home für Entwickler-Hilfeforum. Dort kannst du eine Frage posten, um Hilfe zu erhalten, oder in bereits geposteten Fragen nachsehen, ob deine Frage schon beantwortet wurde.

Wenn Sie einen MCP-Fehler melden oder einen Feature Request stellen möchten, rufen Sie unsere öffentliche Problemverfolgung auf.

Bekannte Probleme

  • Berechtigungsdurchsetzung – Der Zugriff auf das Home-MCP sollte auf Nutzer mit einem Google Home Premium Advanced-Abo beschränkt sein. Ein Fehler ermöglicht Nest Aware Plus-Abonnenten den Zugriff auf das Home-MCP. Wir arbeiten daran, dieses Problem zu beheben, und werden bald eine Lösung veröffentlichen.
  • Testen von Attributen: Damit deine Agents möglichst viele Funktionen bieten, haben wir einige Attribute aufgenommen, die als experimentell gekennzeichnet sind. Es kann vorkommen, dass diese experimentellen Merkmale nicht wie erwartet funktionieren. Wenn ja, melden Sie das Problem bitte über den öffentlichen Issue Tracker.
  • Latenz – Manchmal kann es bei Home MCP zu einer längeren Latenz als erwartet kommen. Wir arbeiten bereits an Optimierungen. In zukünftigen Versionen wird die Latenz voraussichtlich verbessert.