{"slug": "google-home-mcp-server", "title": "Google Home MCP Server", "summary": "Google released an early-access Google Home Model Context Protocol (MCP) server that lets AI-powered development tools and virtual assistants inspect home structures, monitor device states, execute control actions, and analyze historical events through standard MCP tools and RPC interfaces. The server exposes five core capabilities — list_homes, list_home_resources, list_home_states, run_home_actions, and list_home_history — and requires an active Google Home Premium Advanced subscription, a Google Cloud project, and an MCP-compatible AI client such as Google Antigravity, Claude Cowork, or OpenClaw. Google enforces rate limits and safety protections such as prohibiting sensitive actions like unlocking doors, and warns that connecting a real home to an AI agent can produce unexpected or undesired behavior and that household members should be informed.", "body_md": "Early Access\n\nThe Google Home Model Context Protocol (MCP) server allows AI-powered development tools and virtual assistants to interact directly with smart home environments. By exposing standard MCP tools and RPC interfaces, the server enables Large Language Models (LLMs) to inspect home structures, monitor device states, execute control actions, and analyze historical events.\n\n **Warning!**\nConnecting a real-life home to an AI agent allows\n  that agent to control devices on your behalf. Home MCP\n  enforces rate limits and safety protections, such as prohibiting sensitive\n  actions like unlocking doors. However, depending on your agent, connecting it\n  to Home MCP can result in unexpected or even undesired behavior. Carefully\n  review developer [policies](https://developers.home.google.com/policies) and [terms\n  of service](https://developers.home.google.com/terms).\n\nIf you choose to connect a Google Home used by other household members with\n  Home MCP, you should inform them that your agent can control devices and\n  access home data. Alternatively, you can\n  [create an\n    additional home](https://support.google.com/googlehome/answer/17074648) and set up devices for development and testing.\n\nYour agent's access to Home MCP can be\n  [revoked](https://support.google.com/googlehome/answer/14658393) at\n  any time from the Google Home app (GHA) or your My Accounts page.\n\n## Overview\n\nAn MCP server acts as a proxy between smart home infrastructure and AI applications. The Home MCP server exposes executable tools that allow AI clients to query real-time home telemetry and issue commands.\n\n### Core capabilities\n\nThe Home MCP server provides several core capability areas:\n\n- **Structure discovery:** Retrieve accessible homes and structures using`list_homes` .\n- **Resource discovery:** List devices, area layouts, traits, attributes, and\ncommand schemas using`list_home_resources` .\n- **State monitoring:** Check real-time device connectivity status and trait\nstates using`list_home_states` .\n- **Device control:** Execute parameterized action commands on target devices\nusing`run_home_actions` .\n- **Historical analysis:** Query past state changes and event logs over specific\ntime ranges using`list_home_history` .\n\n## Prerequisites\n\nBefore setting up the Home MCP server, ensure you have the following:\n\n- An active smart home setup in Google Home with connected devices.\n- An active Google Home Premium Advanced subscription.\n- Access to a Google Cloud project.\n- An MCP-compatible AI client or application, such as Google Antigravity, Claude Cowork, or OpenClaw.\n\n## Configure the MCP server\n\nSetting up the MCP server requires creating a Google Cloud project, obtaining access approval, enabling the Home API, and generating OAuth credentials.\n\n### Create a Google Cloud project\n\nIf you don't have a Google Cloud already, you must create one:\n\n1. Open the [Google Cloud console](https://console.cloud.google.com/) .\n2. Create a new Google Cloud project.\n\nFor more information, see [Create\nprojects](https://docs.cloud.google.com/resource-manager/docs/creating-managing-projects) \narticle in the Google Cloud documentation.\n\n### Enable the Home API\n\n1. In the Google Cloud console navigation menu, select **APIs & Services** >**Enabled APIs & Services** .\n2. Search for **Home API** and click**Enable** .\n\n### Configure OAuth consent and credentials\n\n1. Configure the OAuth consent screen:\n  1. Open **APIs & Services** >**OAuth consent screen** .\n  2. Select **External** audience, click**Get started** , and fill in the\nrequired app information and contact email.\n2. Open \n3. Create an OAuth client ID:\n  1. Open **APIs & Services** >**Credentials** .\n  2. Click **+ Create credentials** and select**OAuth client ID** .\n  3. Set **Application type** to**Web application** .\n  4. Add the authorized redirect URIs corresponding to your target AI clients:\n    - **Google Antigravity:**`https://antigravity.google/oauth-callback`\n    - **Claude Cowork:**`https://claude.ai/api/mcp/auth_callback`\n    - **OpenClaw:** Redirect URI specified by your local OpenClaw installation\n  5. Click **Create** and copy your**Client ID** and**Client Secret** to a\nsecure location.\n4. Open \n5. Publish your application:\n  1. Open **Google Auth Platform** >**Audience** .\n  2. Under **Publishing status** , click**Publish app** .\n6. Open \n\n## Configure your AI client\n\nYou can configure several AI development environments to connect to the Home MCP server using OAuth authentication. Enter your OAuth Client ID and Client Secret here, then follow your preferred setup instructions.\n\n```\nEnter your Client ID: YOUR_CLIENT_ID\nEnter your Client Secret: YOUR_CLIENT_SECRET\n```\n\n### Automated setup using a prompt\n\nIf your AI assistant supports managing MCP tool configurations directly from chat, you can instruct your assistant to configure the server by pasting the following prompt:\n\n```\nPlease configure the Home MCP server for me with these settings:\n- Name: home_mcp\n- Server URL: https://preprod-home.sandbox.googleapis.com/mcp\n- Transport: sse\n- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2\n- Client ID: YOUR_CLIENT_ID\n- Client Secret: YOUR_CLIENT_SECRET\n```\n\n### Manual setup\n\nSelect your preferred AI tool for manual setup instructions.\n\n### Antigravity\n\nGoogle Antigravity provides built-in integration for MCP servers across its CLI, IDE, and desktop environments.\n\n1. Open the application configuration menu: **Settings** >**Advanced settings** >**Customizations** >**Open MCP Config** .\n2. Add the `home_mcp` entry under the`mcpServers` configuration object:\n\n```\n{\n  \"mcpServers\": {\n    \"home_mcp\": {\n      \"serverUrl\": \"https://home.googleapis.com/mcp\",\n      \"oauth\": {\n        \"clientId\": \"YOUR_CLIENT_ID\",\n        \"clientSecret\": \"YOUR_CLIENT_SECRET\"\n      }\n    }\n  }\n}\n```\n\n3. Complete authentication: Navigate to **Settings** >**Advanced settings** >**Customizations** >**home_mcp** >**Authentication** .\n4. Complete the Google Home permissions flow in your web browser, select your home structure, and copy the authorization code back into Antigravity.\n\nFor more information, see the [Google Antigravity\ndocumentation](https://antigravity.google/docs/mcp).\n\n### Claude\n\nConfigure Claude Cowork to connect to your custom home MCP server:\n\n1. Open [Claude Connectors](https://claude.ai/customize/connectors) .\n2. Click **+** and select**Add custom connector** .\n3. Enter the server URL:\n`https://home.googleapis.com/mcp` .\n4. Click **Advanced settings** and enter your**Client ID** and**Client Secret** .\n5. Click **Add** and complete the OAuth authorization flow in your browser.\n6. In a Cowork chat, click **+** in the lower-left corner, select**Connectors** , and toggle**home_mcp** on.\n\nFor more information, see the [Claude Platform\ndocumentation](https://platform.claude.com/docs/en/home).\n\n### OpenClaw\n\nConfigure OpenClaw to connect to the remote SSE transport with OAuth authentication:\n\n1. Prepare the configuration patch JSON block: \n\n```\n{\n  \"mcp\": {\n    \"servers\": {\n      \"home_mcp\": {\n        \"url\": \"https://home.googleapis.com/mcp\",\n        \"transport\": \"sse\",\n        \"auth\": \"oauth\",\n        \"oauth\": {\n          \"scope\": \"https://www.googleapis.com/auth/home.platform.v2\",\n          \"redirectUrl\": \"[YOUR_OPENCLAW_REDIRECT_URL]\"\n        },\n        \"env\": {\n          \"CLIENT_ID\": \"YOUR_CLIENT_ID\",\n          \"CLIENT_SECRET\": \"YOUR_CLIENT_SECRET\"\n        }\n      }\n    }\n  }\n}\n```\n\n2. Apply the configuration patch in your terminal: \n\n```\nopenclaw config patch --stdin\n```\n\n3. Restart the OpenClaw gateway: \n\n```\nopenclaw gateway restart\n```\n\n4. Initiate the authentication flow: \n\n```\nopenclaw mcp login home_mcp\n```\n\n5. Follow the generated authorization URL to sign in and grant access.\n\nFor more information, see the [OpenClaw\ndocumentation](https://docs.openclaw.ai).\n\n## Familiar face consent\n\nTo access familiar faces data in the Home MCP, users must explicitly consent to this feature separately.\n\n### Prerequisites\n\n- The user granting consent must be a manager of the Google Home structure.\n- The user's structure must have at least one compatible\nGoogle Nest camera or doorbell and an active\nGoogle Home Premium subscription with **Familiar face detection** enabled for*each camera or doorbell* .\n- Your application must have an OAuth 2.0 Client ID created in\nGoogle Cloud. See [Configure your AI\nclient](#configure_your_ai_client) to create an OAuth 2.0 Client if you\nhaven't already done so.\n\n### Consent links\n\nTo grant your application access, you must visit a consent link personalized with your OAuth 2.0 Client ID and Home Structure ID. There are two ways to get your consent link.\n\nOnce you have your link, visit it and provide consent.\n\n### Agent creates the link\n\nIf your agent is already connected to the Home MCP, it can automatically locate your Home Structure ID and generate a ready-to-click link.\n\nUpdate the following parameters directly on this page, then copy-paste the customized prompt into your agent's chat.\n\n- `CLIENT_ID` — Your OAuth 2.0\n          Client ID from Google Cloud. For example,\n          `123456789-xyz.apps.googleusercontent.com`.\n- `STRUCTURE_NAME` — The\n          name of the target Home structure.\n\n```\nPlease query my Home MCP to find the\nStructure ID for my home named STRUCTURE_NAME. Once found, display\nthe structure name and ID, generate my clickable Familiar Faces Consent Link by\nreplacing <STRUCTURE_ID> in this URL with the structure ID you found:\nhttps://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com\n```\n\n### You create the link\n\nIf your agent is already connected to the Home MCP, it can automatically locate your Home Structure ID and generate a ready-to-click link.\n\nUpdate the following parameters directly on this page, then open the customized link in a web browser.\n\n- `CLIENT_ID` — Your OAuth 2.0\n          Client ID from Google Cloud. For example,\n          `123456789-xyz.apps.googleusercontent.com`.\n- `STRUCTURE_ID` — The UUID\n          of the target Home structure. The easiest way to\n          get this is to ask your agent using the Home MCP, \"Tell me the\n          structure ID (UUID) for [Structure Name].\"\n\n```\nhttps://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com\n```\n\n## Verify connection and functionality\n\nOnce your client is configured and authenticated, verify the server connection:\n\n1. Launch your AI assistant or workspace session.\n2. Check active MCP server connections (in Antigravity, run `/mcp` or inspect\ntool lists).\n3. Confirm that `home_mcp` is listed with active tools.\n4. Issue sample prompts to your assistant to test different capabilities: \n  - **Entity discovery:**`How many lights do I have in my house?`\n  - **Real-time state monitoring:**`Is my home secured?`\n  - **Device control:**`Turn off all the outside lights.`\n  - **Historical event analysis:**`What happened while I was out?`\n5. Grant tool execution permissions when prompted by your client. The AI assistant can retrieve real-time state data and all responses will be grounded in your home telemetry.\n\n## Support\n\nFor Home MCP development support, head to the [Smart Home for Developers Help\nCommunity](https://support.google.com/googlehome/community?product_label=gh-developer) \nThere you can post a question to get help, or look through previously posted\nquestions to see if your question has already been answered.\n\nTo file a MCP bug or feature request, head to our [public issue\ntracker](https://issuetracker.google.com/issues/new?component=655104&template=2399599).\n\n### Known Issues\n\n- Trait Testing — To provide the broadest set of functionality for your agents\nwe've included some traits that are marked experimental. You may encounter\nscenarios where these experimental traits don't work as expected. If so,\nplease use the [public issue\ntracker](https://issuetracker.google.com/issues/new?component=655104&template=2399599) to report.\n- Latency — At times you may notice longer than expected latency with Home MCP. We are actively working on optimizations. Expect to see latency improvements in future releases.\n\n### Coming Soon\n\n- Automations — Creating and managing automations with Home MCP is not supported at this time. We are working on this functionality and plan to release automations support in a future release.", "url": "https://wpnews.pro/news/google-home-mcp-server", "canonical_source": "https://developers.home.google.com/mcp/home", "published_at": "2026-09-21 08:12:06+00:00", "updated_at": "2026-09-21 08:23:28.503916+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-products", "ai-tools"], "entities": ["Google", "Google Home", "Model Context Protocol", "Google Home Premium Advanced", "Google Cloud", "Google Antigravity", "Claude Cowork", "OpenClaw"], "alternates": {"html": "https://wpnews.pro/news/google-home-mcp-server", "markdown": "https://wpnews.pro/news/google-home-mcp-server.md", "text": "https://wpnews.pro/news/google-home-mcp-server.txt", "jsonld": "https://wpnews.pro/news/google-home-mcp-server.jsonld"}}