Google Home MCP 服务器

   抢先体验   

借助 Google Home Model Context Protocol (MCP) 服务器，AI 赋能的开发者工具和虚拟助理可以直接与智能家居环境进行交互。通过公开标准 MCP 工具和 RPC 接口，该服务器使大语言模型 (LLM) 能够检查住宅结构、监控设备状态、执行控制操作以及分析历史事件。

警告！

将现实生活中的住宅连接到 AI 智能体后，该智能体便可代表您控制设备。Home MCP 会强制执行速率限制和安全保护措施，例如禁止执行开锁等敏感操作。不过，根据智能体的不同，将其连接到 Home MCP 可能会导致意外甚至不希望出现的行为。仔细查看开发者政策和服务条款。

如果你选择将其他家庭成员使用的 Google Home 与 Home MCP 相关联，则应告知他们，你的代理可以控制设备并访问住宅数据。或者，您也可以创建其他住宅，并设置用于开发和测试的设备。

您可以随时通过 Google Home app (GHA) 或“我的账号”页面撤消代理对 Home MCP 的访问权限。

概览

MCP 服务器充当智能家居基础设施与 AI 应用之间的代理。Home MCP 服务器会公开可执行工具，让 AI 客户端能够查询实时家居遥测数据并发出指令。

核心功能

Home MCP 服务器提供多个核心功能领域：

  • 结构发现：使用 list_homes 检索可访问的住宅和结构。
  • 资源发现：使用 list_home_resources 列出设备、区域布局、特征、属性和命令架构。
  • 状态监控：使用 list_home_states 查看实时设备连接状态和特征状态。
  • 设备控制：使用 run_home_actions 在目标设备上执行参数化操作命令。
  • 历史分析：使用 list_home_history 查询特定时间范围内的过去状态更改和事件日志。

前提条件

在设置 Home MCP 服务器之前，请确保您已准备好以下各项：

  • 在 Google Home 中设置了有效的智能家居，并连接了设备。
  • 有效的 Google Home Premium Advanced 订阅。
  • 对 Google Cloud 项目的访问权限。
  • 与 MCP 兼容的 AI 客户端或应用，例如 Google Antigravity、Claude Cowork 或 OpenClaw。

配置 MCP 服务器

设置 MCP 服务器需要创建 Google Cloud 项目、获取访问权限审批、启用 Home API 并生成 OAuth 凭证。

创建 Google Cloud 项目

如果您还没有 Google Cloud，则必须创建一个：

  1. 打开 Google Cloud 控制台。
  2. 创建新的 Google Cloud 项目。

如需了解详情，请参阅 Google Cloud 文档中的创建项目一文。

启用 Home API

  1. 在 Google Cloud 控制台导航菜单中，依次选择 API 和服务 > 已启用的 API 和服务。
  2. 搜索 Home API，然后点击启用。
  1. 配置 OAuth 权限请求页面：
    1. 依次打开 API 和服务 > OAuth 权限请求页面。
    2. 选择外部受众群体，点击开始，然后填写所需的应用信息和联系邮箱。
  2. 创建 OAuth 客户端 ID：
    1. 依次打开 API 和服务 > 凭证。
    2. 点击 + 创建凭证，然后选择 OAuth 客户端 ID。
    3. 将应用类型设置为 Web 应用。
    4. 添加与目标 AI 客户端对应的已获授权的重定向 URI：
      • Google Antigravity： https://antigravity.google/oauth-callback
      • Claude Cowork： https://claude.ai/api/mcp/auth_callback
      • OpenClaw：由本地 OpenClaw 安装指定的重定向 URI
    5. 点击创建，然后将客户端 ID 和客户端密钥复制到安全位置。
  3. 发布应用：
    1. 依次打开 Google Auth Platform > 受众群体。
    2. 在发布状态下，点击发布应用。

配置 AI 客户端

您可以配置多个 AI 开发环境，以便使用 OAuth 身份验证连接到 Home MCP 服务器。在此处输入您的 OAuth 客户端 ID 和客户端密钥，然后按照您首选的设置说明操作。

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

使用提示进行自动设置

如果您的 AI 助理支持直接通过对话管理 MCP 工具配置，您可以粘贴以下提示，指示助理配置服务器：

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

手动设置

选择您首选的 AI 工具，查看手动设置说明。

Antigravity

Google Antigravity 在其 CLI、IDE 和桌面环境中为 MCP 服务器提供内置集成。

  1. 打开应用配置菜单：设置 > 高级设置 > 自定义 > 打开 MCP 配置。

  2. 在 mcpServers 配置对象下添加 home_mcp 条目：

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

  3. 完成身份验证：依次前往设置 > 高级设置 > 自定义 > home_mcp > 身份验证。

  4. 在网络浏览器中完成 Google Home 权限流程，选择您的住宅结构，然后将授权代码复制回 Antigravity。

如需了解详情，请参阅 Google Antigravity 文档。

Claude

配置 Claude Cowork 以连接到自定义家庭 MCP 服务器：

  1. 打开 Claude Connectors。
  2. 点击 +，然后选择添加自定义连接器。
  3. 输入服务器网址：https://home.googleapis.com/mcp。
  4. 点击高级设置，然后输入客户端 ID 和客户端密钥。
  5. 点击添加，然后在浏览器中完成 OAuth 授权流程。
  6. 在 Cowork 对话中，点击左下角的 +，选择连接器，然后开启 home_mcp。

如需了解详情，请参阅 Claude 平台文档。

OpenClaw

将 OpenClaw 配置为通过 OAuth 身份验证连接到远程 SSE 传输：

  1. 准备配置补丁 JSON 块：

    {
  "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. 在终端中应用配置补丁：

    openclaw config patch --stdin

  3. 重启 OpenClaw 网关：

    openclaw gateway restart

  4. 启动身份验证流程：

    openclaw mcp login home_mcp

  5. 按照生成的授权网址登录并授予访问权限。

如需了解详情，请参阅 OpenClaw 文档。

如需在 Home MCP 中访问熟面孔数据，用户必须单独明确同意使用此功能。

前提条件

  • 表示同意的用户必须是 Google Home 结构的管理员。
  • 用户的住宅中必须至少有一个兼容的 Google Nest 摄像头或门铃，并且必须有有效的 Google Home Premium 订阅，同时为每个摄像头或门铃启用了熟面孔检测功能。
  • 您的应用必须具有在 Google Cloud 中创建的 OAuth 2.0 客户端 ID。如果您尚未创建 OAuth 2.0 客户端，请参阅配置 AI 客户端。

如需向您的应用授予访问权限，您必须访问使用您的 OAuth 2.0 客户端 ID 和 Home 结构 ID 个性化的同意链接。您可以通过以下两种方式获取同意链接。

获得链接后，请访问该链接并提供同意声明。

如果您的智能体已连接到 Home MCP，它可以自动找到您的 Home 结构 ID，并生成一个可点击的链接。

直接在此页面上更新以下参数，然后将自定义提示复制并粘贴到代理的对话中。

  • CLIENT_ID - Google Cloud 中的 OAuth 2.0 客户端 ID。例如，`123456789-xyz.apps.googleusercontent.com`。
  • STRUCTURE_NAME - 目标 Home 结构的名称。
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

如果您的智能体已连接到 Home MCP，它可以自动找到您的 Home 结构 ID，并生成一个可点击的链接。

直接在此页面上更新以下参数，然后在网络浏览器中打开自定义链接。

  • CLIENT_ID - Google Cloud 中的 OAuth 2.0 客户端 ID。例如，`123456789-xyz.apps.googleusercontent.com`。
  • STRUCTURE_ID - 目标 Home 结构的 UUID。最简单的方法是使用 Home MCP 询问您的代理：“告诉我 [结构名称] 的结构 ID (UUID)。”
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

验证连接和功能

配置客户端并完成身份验证后，请验证服务器连接：

  1. 启动 AI 助理或工作区会话。
  2. 检查活跃的 MCP 服务器连接（在 Antigravity 中，运行 /mcp 或检查工具列表）。
  3. 确认 home_mcp 已列在有效工具中。

  4. 向助理发出示例提示，以测试不同的功能：

    • 实体发现： How many lights do I have in my house?
    • 实时状态监控： Is my home secured?
    • 设备控制： Turn off all the outside lights.
    • 历史事件分析： What happened while I was out?

  5. 当客户端提示时，授予工具执行权限。AI 助理可以检索实时状态数据，并且所有回答都将基于住宅遥测数据。

支持

如需 Home MCP 开发支持，请前往面向开发者的智能家居帮助社区。 您可以在该社区中发帖提问以获取帮助，也可以浏览之前发布的问题，看看您的问题是否已得到解答。

如需提交 MCP 错误或功能请求，请前往我们的公开问题跟踪器。

已知问题

  • 权限强制执行 - 只有拥有 Google Home Premium Advanced 订阅的用户才能访问 Home MCP。目前，由于一个 bug，Nest Aware Plus 订阅者可以访问 Home MCP。我们正在努力解决此问题，很快就会发布修复程序。
  • 特征测试 - 为了给您的代理提供最广泛的功能，我们添加了一些标记为实验性的特征。您可能会遇到这些实验性特征无法按预期工作的情况。如果是，请使用公开问题跟踪器进行报告。
  • 延迟时间 - 有时，您可能会发现 Home MCP 的延迟时间比预期长。我们正在积极进行优化。预计未来版本中延迟时间会有所缩短。

即将推出

  • 自动化操作 - 目前不支持使用 Home MCP 创建和管理自动化操作。我们正在开发此功能，并计划在未来版本中发布自动化支持。