Serveur MCP Google Home

   Accès anticipé   

Le serveur MCP (Model Context Protocol) Google Home permet aux outils pour les développeurs et aux assistants virtuels optimisés par l'IA d'interagir directement avec les environnements de maison connectée. En exposant des outils MCP et des interfaces RPC standards, le serveur permet aux grands modèles de langage (LLM) d'inspecter les structures de maison, de surveiller l'état des appareils, d'exécuter des actions de contrôle et d'analyser l'historique des événements.

 Avertissement

Connecter une maison réelle à un agent IA permet à cet agent de contrôler des appareils en votre nom. Le MCP Home applique des limites de débit et des protections de sécurité, par exemple en interdisant les actions sensibles telles que le déverrouillage des portes. Toutefois, selon votre agent, le connecter à Home MCP peut entraîner un comportement inattendu, voire indésirable. Lisez attentivement les Règles et les Conditions d'utilisation pour les développeurs.

Si vous choisissez de connecter un Google Home utilisé par d'autres membres de la maison à Home MCP, vous devez les informer que votre agent peut contrôler les appareils et accéder aux données de la maison. Vous pouvez également créer une maison supplémentaire et configurer des appareils pour le développement et les tests.

L'accès de votre agent à Home MCP peut être révoqué à tout moment depuis Google Home app (GHA) ou la page "Mes comptes".

Présentation

Un serveur MCP sert de proxy entre l'infrastructure de la maison connectée et les applications d'IA. Le serveur MCP Home expose des outils exécutables qui permettent aux clients IA d'interroger la télémétrie de la maison en temps réel et d'émettre des commandes.

Fonctionnalités de base

Le serveur MCP Home propose plusieurs domaines de fonctionnalités de base :

  • Découverte de structures : récupérez les maisons et les structures accessibles à l'aide de list_homes.
  • Découverte de ressources : listez les appareils, les agencements de zones, les caractéristiques, les attributs et les schémas de commande à l'aide de list_home_resources.
  • Surveillance de l'état : vérifiez l'état de la connectivité de l'appareil et l'état des caractéristiques en temps réel à l'aide de list_home_states.
  • Contrôle des appareils : exécutez des commandes d'action paramétrées sur les appareils cibles à l'aide de run_home_actions.
  • Analyse de l'historique : interrogez les modifications d'état et les journaux d'événements passés sur des périodes spécifiques à l'aide de list_home_history.

Prérequis

Avant de configurer le serveur MCP Home, assurez-vous de disposer des éléments suivants :

  • Une configuration de maison connectée active dans Google Home avec des appareils connectés.
  • Un abonnement Google Home Premium Advanced actif.
  • Accès à un projet Google Cloud.
  • Un client ou une application d'IA compatible avec MCP, comme Google Antigravity, Claude Cowork ou OpenClaw.

Configurer le serveur MCP

Pour configurer le serveur MCP, vous devez créer un projet Google Cloud, obtenir l'approbation d'accès, activer l'API Home et générer des identifiants OAuth.

Créer un projet Google Cloud

Si vous n'avez pas encore de Google Cloud, vous devez en créer un :

  1. Ouvrez la console Google Cloud.
  2. Créez un projet Google Cloud.

Pour en savoir plus, consultez l'article Créer des projets dans la documentation Google Cloud.

Activer l'API Home

  1. Dans le menu de navigation de la consoleGoogle Cloud, sélectionnez API et services > API et services activés.
  2. Recherchez API Home, puis cliquez sur Activer.
  1. Configurez l'écran de consentement OAuth :
    1. Ouvrez API et services > Écran de consentement OAuth.
    2. Sélectionnez l'audience Externe, cliquez sur Commencer, puis renseignez les informations requises sur l'application et l'adresse e-mail de contact.
  2. Créez un ID client OAuth :
    1. Ouvrez API et services > Identifiants.
    2. Cliquez sur + Créer des identifiants, puis sélectionnez ID client OAuth.
    3. Définissez le paramètre Type d'application sur Application Web.
    4. Ajoutez les URI de redirection autorisés correspondant à vos clients d'IA cibles :
      • Google Antigravity : https://antigravity.google/oauth-callback
      • Claude Cowork : https://claude.ai/api/mcp/auth_callback
      • OpenClaw : URI de redirection spécifié par votre installation OpenClaw locale
    5. Cliquez sur Créer, puis copiez votre ID client et votre code secret du client dans un emplacement sécurisé.
  3. Publiez votre application :
    1. Ouvrez Google Auth Platform > Audience.
    2. Sous État de publication, cliquez sur Publier l'application.

Configurer votre client IA

Vous pouvez configurer plusieurs environnements de développement d'IA pour qu'ils se connectent au serveur MCP Home à l'aide de l'authentification OAuth. Saisissez ici votre ID client et votre code secret du client OAuth, puis suivez les instructions de configuration de votre choix.

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

Configuration automatisée à l'aide d'un prompt

Si votre assistant IA permet de gérer les configurations des outils MCP directement depuis le chat, vous pouvez lui demander de configurer le serveur en collant la requête suivante :

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

Configuration manuelle

Sélectionnez l'outil d'IA de votre choix pour obtenir des instructions de configuration manuelle.

Antigravity

Google Antigravity fournit une intégration intégrée pour les serveurs MCP dans ses environnements CLI, IDE et de bureau.

  1. Ouvrez le menu de configuration de l'application : Settings (Paramètres) > Advanced settings (Paramètres avancés) > Customizations (Personnalisations) > Open MCP Config (Ouvrir la configuration MCP).

  2. Ajoutez l'entrée home_mcp sous l'objet de configuration mcpServers :

    {
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

  3. Effectuez l'authentification : accédez à Paramètres > Paramètres avancés > Personnalisations > home_mcp > Authentification.

  4. Suivez la procédure d'autorisation Google Home dans votre navigateur Web, sélectionnez votre structure de maison, puis copiez le code d'autorisation dans Antigravity.

Pour en savoir plus, consultez la documentation Google Antigravity.

Claude

Configurez Claude Cowork pour qu'il se connecte à votre serveur MCP domestique personnalisé :

  1. Ouvrez Claude Connectors.
  2. Cliquez sur +, puis sélectionnez Ajouter un connecteur personnalisé.
  3. Saisissez l'URL du serveur : https://home.googleapis.com/mcp.
  4. Cliquez sur Paramètres avancés, puis saisissez votre ID client et votre code secret du client.
  5. Cliquez sur Ajouter et suivez la procédure d'autorisation OAuth dans votre navigateur.
  6. Dans un chat Cowork, cliquez sur + en bas à gauche, sélectionnez Connecteurs, puis activez home_mcp.

Pour en savoir plus, consultez la documentation de la plate-forme Claude.

OpenClaw

Configurez OpenClaw pour qu'il se connecte au transport SSE distant avec l'authentification OAuth :

  1. Préparez le bloc JSON du correctif de configuration :

    {
  "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. Appliquez le correctif de configuration dans votre terminal :

    openclaw config patch --stdin

  3. Redémarrez la passerelle OpenClaw :

    openclaw gateway restart

  4. Lancez le flux d'authentification :

    openclaw mcp login home_mcp

  5. Suivez l'URL d'autorisation générée pour vous connecter et accorder l'accès.

Pour en savoir plus, consultez la documentation OpenClaw.

Pour accéder aux données de visages familiers dans le Home MCP, les utilisateurs doivent donner explicitement leur consentement pour cette fonctionnalité séparément.

Prérequis

  • L'utilisateur qui donne son consentement doit être un gestionnaire de la structure Google Home.
  • La structure de l'utilisateur doit disposer d'au moins une caméra ou une sonnette Google Nest compatible et d'un abonnement Google Home Premium actif avec la détection des visages familiers activée pour chaque caméra ou sonnette.
  • Votre application doit disposer d'un ID client OAuth 2.0 créé dans Google Cloud. Consultez Configurer votre client d'IA pour créer un client OAuth 2.0 si vous ne l'avez pas déjà fait.

Pour accorder l'accès à votre application, vous devez accéder à un lien de consentement personnalisé avec votre ID client OAuth 2.0 et votre ID de structure Home. Il existe deux façons d'obtenir votre lien de consentement.

Une fois que vous avez votre lien, accédez-y et donnez votre consentement.

Si votre agent est déjà connecté au MCP Home, il peut localiser automatiquement l'ID de votre structure Home et générer un lien prêt à être cliqué.

Mettez à jour les paramètres suivants directement sur cette page, puis copiez-collez le prompt personnalisé dans le chat de votre agent.

  • CLIENT_ID : votre ID client OAuth 2.0 de Google Cloud. Par exemple, "123456789-xyz.apps.googleusercontent.com".
  • STRUCTURE_NAME : nom de la structure Home cible.
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

Si votre agent est déjà connecté au MCP Home, il peut localiser automatiquement l'ID de votre structure Home et générer un lien prêt à être cliqué.

Mettez à jour les paramètres suivants directement sur cette page, puis ouvrez le lien personnalisé dans un navigateur Web.

  • CLIENT_ID : votre ID client OAuth 2.0 de Google Cloud. Par exemple, "123456789-xyz.apps.googleusercontent.com".
  • STRUCTURE_ID : UUID de la structure Home cible. Le moyen le plus simple de l'obtenir est de demander à votre agent en utilisant le MCP Home : "Donne-moi l'ID de structure (UUID) de [nom de la structure]".
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

Vérifier la connexion et le fonctionnement

Une fois votre client configuré et authentifié, vérifiez la connexion au serveur :

  1. Lancez votre assistant IA ou votre session d'espace de travail.
  2. Vérifiez les connexions actives au serveur MCP (dans Antigravity, exécutez /mcp ou inspectez les listes d'outils).
  3. Vérifiez que home_mcp figure dans la liste des outils actifs.

  4. Envoyez des exemples de requêtes à votre assistant pour tester différentes fonctionnalités :

    • Découverte d'entités : How many lights do I have in my house?
    • Surveillance de l'état en temps réel : Is my home secured?
    • Contrôle de l'appareil : Turn off all the outside lights.
    • Analyse de l'historique des événements : What happened while I was out?

  5. Accordez les autorisations d'exécution de l'outil lorsque votre client vous y invite. L'assistant IA peut récupérer des données d'état en temps réel, et toutes les réponses seront ancrées dans la télémétrie de votre maison.

Assistance

Pour obtenir de l'aide sur le développement de Home MCP, accédez à la communauté d'aide Smart Home pour les développeurs. Vous pourrez y poser une question pour obtenir de l'aide ou parcourir les questions déjà posées pour voir si une réponse a déjà été apportée à votre question.

Pour signaler un bug ou demander une fonctionnalité MCP, accédez à notre outil public de suivi des problèmes.

Problèmes connus

  • Application des droits : l'accès à Home MCP doit être limité aux utilisateurs disposant d'un abonnement Google Home Premium Advanced. Actuellement, un bug permet aux abonnés Nest Aware Plus d'accéder à Home MCP. Nous mettons tout en œuvre pour résoudre ce problème au plus vite.
  • Test des caractéristiques : pour fournir l'ensemble de fonctionnalités le plus large possible pour vos agents, nous avons inclus certaines caractéristiques marquées comme expérimentales. Il est possible que ces caractéristiques expérimentales ne fonctionnent pas comme prévu dans certains cas. Si c'est le cas, veuillez utiliser la version publique d'Issue Tracker pour le signaler.
  • Latence : vous pouvez parfois constater une latence plus longue que prévu avec Home MCP. Nous travaillons activement à l'optimisation de cette fonctionnalité. La latence devrait être améliorée dans les prochaines versions.

Bientôt disponible

  • Automatisations : la création et la gestion d'automatisations avec Home MCP ne sont pas disponibles pour le moment. Nous travaillons sur cette fonctionnalité et prévoyons de proposer la compatibilité avec les automatisations dans une prochaine version.