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.

warning Warnung!

Wenn du ein echtes Zuhause mit einem KI-Agenten verbindest, kann dieser Agent Geräte in deinem 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 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 zum Zuhause abfragen und Befehle senden können.

Hauptfunktionen

Der Home-MCP-Server bietet mehrere Kernfunktionen:

• Gebäudeerkennung:Mit list_homes kannst du zugängliche Zuhause und Gebäude abrufen.
• 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: Parametrisierte Aktionsbefehle auf Zielgeräten mit run_home_actions ausführen.
• Verlaufsanalyse: Mit list_home_history können Sie vergangene Statusänderungen und Ereignisprotokolle für bestimmte Zeiträume abfragen.

Vorbereitung

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

• 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

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.

OAuth-Zustimmung und ‑Anmeldedaten konfigurieren

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. Erstellen Sie eine OAuth-Client-ID:
   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: Weiterleitungs-URI, der von Ihrer lokalen OpenClaw-Installation angegeben wird
   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 sich über die OAuth-Authentifizierung mit dem Home MCP-Server verbinden. 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: 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 für die manuelle Einrichtung zu erhalten.

Einwilligung zur Gesichtswiedererkennung

Damit Nutzer im Home MCP auf Daten zur Gesichtswiedererkennung 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.

Einwilligungslinks

Wenn du deiner Anwendung Zugriff gewähren möchtest, 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.

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

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 des 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.

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. Derzeit ermöglicht ein Fehler Nest Aware Plus-Abonnenten den Zugriff auf die Home MCP. Wir arbeiten an einer Lösung für dieses Problem und werden bald ein Update veröffentlichen.
• Testen von Eigenschaften – Um die größtmögliche Funktionalität für deine Agenten zu bieten, haben wir einige Eigenschaften 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 Releases wird die Latenz voraussichtlich verbessert.

Demnächst verfügbar

• Automatisierungen – Das Erstellen und Verwalten von Automatisierungen mit dem 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 zu veröffentlichen.