Google Home MCP-Server

   Early Access   

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

 Achtung!

Wenn Sie ein echtes Zuhause mit einem KI-Agenten verbinden, kann dieser Geräte in Ihrem Namen steuern. Das Home-MCP erzwingt Ratenbeschränkungen 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. Lies dir die Richtlinien für Entwickler*innen und die Nutzungsbedingungen genau durch.

Wenn Sie ein Google Home-Konto, das von anderen Mitgliedern des Zuhauses verwendet wird, mit dem Home MCP verbinden, sollten Sie diese darüber informieren, dass Ihr Agent Geräte steuern und auf Daten des Zuhauses zugreifen kann. Alternativ können Sie ein zusätzliches Zuhause erstellen und Geräte für die Entwicklung und das Testen einrichten.

Der Zugriff Ihres Kundenservicemitarbeiters auf Home MCP kann jederzeit über 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 für das Zuhause abfragen und Befehle ausgeben können.

Hauptfunktionen

Der Home-MCP-Server bietet mehrere Kernfunktionen:

  • Gebäudeerkennung:Rufe mit list_homes zugängliche Haushalte und Gebäude ab.
  • Ressourcensuche:Geräte, Bereichslayouts, Merkmale, Attribute und Befehlsschemas mit list_home_resources auflisten.
  • Statusüberwachung:Mit list_home_states können Sie den Konnektivitätsstatus von Geräten und die Attributstatus in Echtzeit 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 frühere Statusänderungen und Ereignisprotokolle für bestimmte Zeiträume abfragen.

Vorbereitung

Bevor Sie den Home-MCP-Server einrichten, müssen Sie Folgendes erledigt haben:

  • Eine aktive Smart-Home-Einrichtung 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

Für die Einrichtung des MCP-Servers müssen Sie ein Google Cloud-Projekt erstellen, die 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 & Dienste > Aktivierte APIs & Dienste aus.
  2. Suchen Sie nach Home API und klicken Sie auf Aktivieren.
  1. OAuth-Zustimmungsbildschirm konfigurieren:
    1. Öffnen Sie APIs & Dienste > OAuth-Zustimmungsbildschirm.
    2. Wählen Sie die externe Zielgruppe 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 & 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:Weiterleitungs-URI, die von Ihrer lokalen OpenClaw-Installation angegeben wird
    5. Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihren Clientschlüssel an einen sicheren Ort.
  3. Anwendung veröffentlichen:
    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

Automatisierte Einrichtung mit einem Prompt

Wenn Ihr KI-Assistent die Verwaltung von MCP-Toolkonfigurationen direkt über den 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://preprod-home.sandbox.googleapis.com/mcp
- Transport: sse
- 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 zur manuellen Einrichtung zu erhalten.

Antigravity

Google Antigravity bietet eine integrierte Unterstützung für MCP-Server in der CLI, IDE und Desktop-Umgebung.

  1. Öffnen Sie das Menü für die Anwendungskonfiguration: 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 Berechtigungsablauf für Google Home in deinem Webbrowser ab, wähle dein Zuhause aus und kopiere den Autorisierungscode zurück in Antigravity.

Weitere Informationen finden Sie in der Google Antigravity-Dokumentation.

Claude

So konfigurieren Sie Claude Cowork, damit es eine Verbindung zu Ihrem benutzerdefinierten MCP-Server herstellt:

  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

Konfigurieren Sie OpenClaw, um eine Verbindung zum Remote-SSE-Transport mit OAuth-Authentifizierung herzustellen:

  1. Bereiten Sie den JSON-Block für den Konfigurationspatch vor:

    {
  "mcp": {
    "servers": {
      "home_mcp": {
        "url": "https://home.googleapis.com/mcp",
        "transport": "sse",
        "auth": "oauth",
        "oauth": {
          "scope": "https://www.googleapis.com/auth/home.platform.v2",
          "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
        },
        "env": {
          "CLIENT_ID": "YOUR_CLIENT_ID",
          "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
        }
      }
    }
  }
}

  2. Wenden Sie den Konfigurationspatch in Ihrem Terminal an:

    openclaw config patch --stdin

  3. Starten Sie das OpenClaw-Gateway neu:

    openclaw gateway restart

  4. Authentifizierungsvorgang starten:

    openclaw mcp login home_mcp

  5. Folgen Sie der generierten Autorisierungs-URL, um sich anzumelden und Zugriff zu gewähren.

Weitere Informationen finden Sie in der OpenClaw-Dokumentation.

Um im Home-MCP auf Daten zu vertrauten Gesichtern zuzugreifen, müssen Nutzer dieser Funktion separat ausdrücklich zustimmen.

Vorbereitung

  • Der Nutzer, der die Einwilligung erteilt, muss Manager der Google Home-Struktur sein.
  • Im Zuhause des Nutzers muss mindestens eine kompatible Google Nest-Kamera oder ‑Türklingel vorhanden sein. Außerdem muss ein aktives Google Home Premium-Abo mit aktivierter Gesichtswiedererkennung für jede Kamera oder Türklingel bestehen.
  • Für Ihre Anwendung muss eine OAuth 2.0-Client-ID in Google Cloud erstellt werden. Wenn Sie noch keinen OAuth 2.0-Client erstellt haben, lesen Sie den Abschnitt KI-Client konfigurieren.

Damit Sie Ihrer Anwendung Zugriff gewähren können, müssen Sie einen Einwilligungslink aufrufen, der mit Ihrer OAuth 2.0-Client-ID und der Home-Struktur-ID personalisiert ist. Es gibt zwei Möglichkeiten, den Einwilligungslink zu erhalten.

Rufen Sie den Link auf und erteilen Sie die Einwilligung.

Wenn Ihr Kundenservicemitarbeiter bereits mit dem Home MCP verbunden ist, kann er automatisch Ihre Home-Struktur-ID finden und einen klickbereiten Link generieren.

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

  • CLIENT_ID: Ihre OAuth 2.0-Client-ID aus Google Cloud. Beispiel: `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_NAME: Der Name der Zielstruktur Home.
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 Kundenservicemitarbeiter bereits mit dem Home MCP verbunden ist, kann er automatisch Ihre Home-Struktur-ID finden und einen klickbereiten 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 erhalten Sie diese ID, indem Sie Ihren Agenten über den Home-MCP fragen: „Nenne mir die Struktur-ID (UUID) für [Strukturname].“
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 Ihr Client konfiguriert und authentifiziert wurde, prüfen Sie die Serververbindung:

  1. Starten Sie Ihren KI‑Assistenten oder Ihre Arbeitsbereichssitzung.
  2. Aktive MCP-Serververbindungen prüfen (in Antigravity /mcp ausführen oder Toollisten prüfen)
  3. Prüfen Sie, ob home_mcp in der Liste der aktiven Tools aufgeführt ist.

  4. Stellen Sie Ihrem Assistenten Beispiel-Prompts, um verschiedene Funktionen zu testen:

    • Entitätserkennung:How many lights do I have in my house?
    • Statusüberwachung in Echtzeit: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 Kunden dazu aufgefordert werden. Der KI-Assistent kann Echtzeit-Statusdaten abrufen und alle Antworten basieren auf der Telemetrie deines Zuhauses.

Support

Wenn du Unterstützung bei der Entwicklung von Home MCPs benötigst, wende dich an die Smart Home for Developers Help Community. Dort kannst du Fragen stellen oder dir bereits gestellte Fragen ansehen, um herauszufinden, ob deine Frage bereits beantwortet wurde.

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

Bekannte Probleme

  • Trait-Tests: Um Ihren Agents die größtmögliche Funktionalität zu bieten, haben wir einige experimentelle Traits hinzugefügt. Es kann vorkommen, dass diese experimentellen Merkmale nicht wie erwartet funktionieren. Wenn ja, verwenden Sie bitte den öffentlichen Issue Tracker, um das Problem zu melden.
  • Latenz: Manchmal kann es bei Home MCP zu einer längeren als erwarteten Latenz kommen. Wir arbeiten aktiv an Optimierungen. In zukünftigen Releases sind Verbesserungen bei der Latenz zu erwarten.

Demnächst verfügbar

  • Automatisierungen: Das Erstellen und Verwalten von Automatisierungen mit Home MCP wird derzeit nicht unterstützt. Wir arbeiten an dieser Funktion und planen, die Unterstützung für Automatisierungen in einer zukünftigen Version einzuführen.