Serveur MCP Google Home

   Accès anticipé   

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

 Attention !

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

Si vous choisissez d'associer un appareil Google Home utilisé par d'autres membres de la maison à la fonctionnalité Gestion multi-pièces de Home, 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 d'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 fournit plusieurs domaines de fonctionnalités de base :

  • Découverte de structures : récupérez les maisons et structures accessibles à l'aide de list_homes.
  • Découverte des ressources : listez les appareils, les mises en page des 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 connectivité des appareils et les états 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 historique : interrogez les journaux d'événements et les changements d'état passés sur des plages horaires 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 Home API, 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 saisissez 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 Create (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 la publication, cliquez sur Publier l'application.

Configurer votre client d'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 votre ID client et votre code secret du client OAuth ici, puis suivez les instructions de configuration de votre choix.

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

Configuration automatique à l'aide d'un prompt

Si votre assistant IA permet de gérer les configurations d'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://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

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 : Paramètres > Paramètres avancés > Personnalisations > 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. Authentification complète : 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 personnalisé :

  1. Ouvrez Connecteurs Claude.
  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 client.
  5. Cliquez sur Ajouter et suivez le flux d'autorisation OAuth dans votre navigateur.
  6. Dans une discussion 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 sur les visages connus dans le MCP de la maison, les utilisateurs doivent donner leur consentement explicite pour cette fonctionnalité séparément.

Prérequis

  • L'utilisateur qui accorde l'autorisation doit être un administrateur de la structure Google Home.
  • La structure de l'utilisateur doit comporter au moins une caméra ou une sonnette Google Nest compatible et 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 d'autorisation personnalisé avec votre ID client OAuth 2.0 et l'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 à l'emploi.

Modifiez les paramètres suivants directement sur cette page, puis copiez-collez la requête personnalisée dans le chat de votre agent.

  • CLIENT_ID : votre ID client OAuth 2.0 depuis 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 à l'emploi.

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 depuis Google Cloud. Par exemple, `123456789-xyz.apps.googleusercontent.com`.
  • STRUCTURE_ID : UUID de la structure Home cible. Le moyen le plus simple d'obtenir cette information est de demander à votre agent à l'aide de la console MCP pour la maison : "Dis-moi l'ID de structure (UUID) pour [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 une 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 est listé avec les 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 des appareils : Turn off all the outside lights.
    • Analyse des événements historiques : What happened while I was out?

  5. Accorder les autorisations d'exécution des outils 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 MCP pour la maison, rendez-vous sur la communauté d'aide Smart Home for Developers. Vous pourrez y poser une question ou parcourir les questions déjà publiées pour voir si la vôtre a déjà été traitée.

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

Problèmes connus

  • Test des traits : pour offrir l'ensemble de fonctionnalités le plus large possible à vos agents, nous avons inclus certains traits marqués comme expérimentaux. Il est possible que ces caractéristiques expérimentales ne fonctionnent pas comme prévu. Si c'est le cas, veuillez le signaler à l'aide de l'outil public de suivi des problèmes.
  • Latence : il peut arriver que la latence soit plus longue que prévu avec Home MCP. Nous travaillons activement à l'optimisation. Des améliorations de la latence sont prévues dans les prochaines versions.

Bientôt disponible

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