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_homeskannst du auf zugängliche Zuhause und Gebäude zugreifen. - Ressourcenermittlung: Mit
list_home_resourceskannst du Geräte, Bereichslayouts, Eigenschaften, Attribute und Befehlsschemas auflisten. - Statusüberwachung: Mit
list_home_stateskannst du den Echtzeit-Verbindungsstatus und die Attributstatus von Geräten prüfen. - Gerätesteuerung: Mit
run_home_actionskönnen Sie parametrisierte Aktionsbefehle auf Zielgeräten ausführen. - Verlaufsanalyse: Mit
list_home_historykönnen Sie vergangene Statusänderungen und Ereignisprotokolle für bestimmte Zeiträume abfragen. - Automatisierungen: Mit
list_automationskannst du Automatisierungen auflisten und mitsave_automationspeichern.
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:
- Öffnen Sie die Google Cloud-Konsole.
- Erstellen Sie ein neues Google Cloud-Projekt.
Weitere Informationen finden Sie im Artikel Projekte erstellen in der Google Cloud-Dokumentation.
Home API aktivieren
- Wählen Sie im Navigationsmenü der Google Cloud Console APIs und Dienste > Aktivierte APIs und Dienste aus.
- Suchen Sie nach Home API und klicken Sie auf Aktivieren.
OAuth-Zustimmung und ‑Anmeldedaten konfigurieren
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm:
- Öffnen Sie APIs und Dienste > OAuth-Zustimmungsbildschirm.
- 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.
- OAuth-Client-ID erstellen:
- Öffnen Sie APIs und Dienste > Anmeldedaten.
- Klicken Sie auf + Anmeldedaten erstellen und wählen Sie OAuth-Client-ID aus.
- Setzen Sie den Anwendungstyp auf Webanwendung.
- 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
- Google Antigravity:
- Klicken Sie auf Erstellen und kopieren Sie die Client-ID und den Clientschlüssel an einen sicheren Ort.
- Veröffentlichen Sie Ihre Anwendung:
- Öffnen Sie die Google Auth Platform > Zielgruppe.
- 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.
- Öffnen Sie das Konfigurationsmenü der Anwendung: Einstellungen > Erweiterte Einstellungen > Anpassungen > MCP-Konfiguration öffnen.
Fügen Sie den Eintrag
home_mcpunter dem KonfigurationsobjektmcpServershinzu:{ "mcpServers": { "home_mcp": { "serverUrl": "https://home.googleapis.com/mcp", "oauth": { "clientId": "YOUR_CLIENT_ID", "clientSecret": "YOUR_CLIENT_SECRET" } } } }Authentifizierung abschließen: Gehen Sie zu Einstellungen > Erweiterte Einstellungen > Anpassungen > home_mcp > Authentifizierung.
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:
- Öffnen Sie Claude Connectors.
- Klicken Sie auf + und wählen Sie Benutzerdefinierten Connector hinzufügen aus.
- Geben Sie die Server-URL ein:
https://home.googleapis.com/mcp. - Klicken Sie auf Erweiterte Einstellungen und geben Sie Ihre Client-ID und Ihren Clientschlüssel ein.
- Klicken Sie auf Hinzufügen und schließen Sie den OAuth-Autorisierungsvorgang in Ihrem Browser ab.
- 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.
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" }Schränken Sie die Berechtigungen für diese Datei ein, sodass nur Ihr lokales Konto sie lesen kann:
chmod 600 ~/.openclaw/home-mcp-client.jsonRegistrieren Sie den Server in OpenClaw mit
mcp-remote. Ersetzen Sie/absolute/path/todurch den vollständigen Pfad zu Ihrem Verzeichnis mit den Anmeldedaten (mcp-remoteerweitert~nicht). Das Flag--transport http-onlyerzwingt Streamable HTTP,--host 127.0.0.1entspricht dem registrierten Weiterleitungs-URI und--authorize-paramfordert 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" ] }'Starten Sie das OpenClaw-Gateway neu:
openclaw gateway restartFühren Sie
openclaw mcp probe home_mcpaus, um die Anmeldung im Browser abzuschließen und die Toolerkennung zu prüfen.
Weitere Informationen finden Sie in der OpenClaw-Dokumentation.
Einwilligung zur Gesichtswiedererkennung
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.
Einwilligungslinks
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.
KI-Agent erstellt den Link
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
Sie erstellen den Link.
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:
- Starten Sie Ihren KI-Assistenten oder Ihre Workspace-Sitzung.
- Prüfen Sie die aktiven MCP-Serververbindungen (führen Sie in Antigravity
/mcpaus oder prüfen Sie die Toollisten). - Prüfen Sie, ob
home_mcpmit aktiven Tools aufgeführt ist. 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?
- Entitätserkennung:
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.