Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Google Home MCP サーバー

早期アクセス

Google Home Model Context Protocol（MCP）サーバーを使用すると、AI を活用した開発ツールや仮想アシスタントがスマートホーム環境と直接やり取りできます。このサーバーは、標準の MCP ツールと RPC インターフェースを公開することで、大規模言語モデル（LLM）が家のストラクチャの検査、デバイスの状態のモニタリング、制御アクションの実行、過去のイベントの分析を行えるようにします。

警告:

実際の家を AI エージェントに接続すると、そのエージェントがユーザーに代わってデバイスを操作できるようになります。Home MCP は、レート制限と安全保護を適用します。たとえば、ドアのロック解除などの機密性の高いアクションを禁止します。ただし、エージェントによっては、Home MCP に接続すると、予期しない動作や望ましくない動作が発生することがあります。デベロッパーポリシーと利用規約を十分に確認する。

他の家族メンバーが使用している Google Home を Home MCP に接続する場合は、エージェントがデバイスを操作したり、家のデータにアクセスしたりできることを家族メンバーに伝える必要があります。または、別の家を作成して、開発とテスト用のデバイスをセットアップすることもできます。

エージェントの Home MCP へのアクセス権は、Google Home app (GHA) または [マイアカウント] ページからいつでも取り消すことができます。

概要

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 プロジェクトへのアクセス権。
Google Antigravity、Claude Cowork、OpenClaw などの MCP 互換の AI クライアントまたはアプリケーション。

MCP サーバーを構成する

MCP サーバーを設定するには、Google Cloud プロジェクトの作成、アクセス承認の取得、Home API の有効化、OAuth 認証情報の生成が必要です。

Google Cloud プロジェクトを作成する

Google Cloud がまだない場合は、作成する必要があります。

Google Cloud コンソールを開きます。
新しい Google Cloud プロジェクトを作成します。

詳細については、Google Cloud ドキュメントのプロジェクトを作成するをご覧ください。

Home API を有効にする

Google Cloud コンソールのナビゲーションメニューで、[API とサービス] > [有効な API とサービス] を選択します。
Home API を検索し、[有効にする] をクリックします。

OAuth 同意と認証情報を構成する

OAuth 同意画面を構成します。
1. [API とサービス] > [OAuth 同意画面] を開きます。
2. [外部] オーディエンスを選択し、[開始] をクリックして、必要なアプリ情報と連絡先メールアドレスを入力します。
OAuth クライアント ID を作成します。
1. [API とサービス] > [認証情報] を開きます。
2. [+ 認証情報を作成] をクリックし、[OAuth クライアント ID] を選択します。
3. [アプリケーションの種類] を [ウェブアプリケーション] に設定します。
4. ターゲット AI クライアントに対応する承認済みのリダイレクト URI を追加します。
  - Google Antigravity: https://antigravity.google/oauth-callback
  - Claude Cowork: https://claude.ai/api/mcp/auth_callback
  - OpenClaw: ローカルの OpenClaw インストールで指定されたリダイレクト URI
5. [Create] をクリックし、クライアント ID とクライアントシークレットを安全な場所にコピーします。
アプリケーションを公開します。
1. [Google Auth Platform] > [Audience] を開きます。
2. [公開ステータス] で、[アプリを公開] をクリックします。

AI クライアントを構成する

OAuth 認証を使用して Home MCP サーバーに接続するように、複数の AI 開発環境を構成できます。ここに 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 サーバーの組み込み統合を提供します。

アプリケーション構成メニューを開きます。Settings > Advanced settings > Customizations > Open MCP Config。

mcpServers 構成オブジェクトに home_mcp エントリを追加します。

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

認証を完了する: [設定] > [詳細設定] > [カスタマイズ] > [home_mcp] > [認証] に移動します。
ウェブブラウザで Google Home の権限フローを完了し、家のストラクチャを選択して、認証コードを Antigravity にコピーします。

詳細については、Google Antigravity のドキュメントをご覧ください。

Claude

カスタムのホーム MCP サーバーに接続するように Claude Cowork を構成します。

Claude コネクタを開きます。
[+] をクリックし、[カスタムコネクタを追加] を選択します。
サーバー URL https://home.googleapis.com/mcp を入力します。
[詳細設定] をクリックし、クライアント ID とクライアントシークレットを入力します。
[Add] をクリックし、ブラウザで OAuth 認証フローを完了します。
Cowork チャットで、左下の + をクリックし、[コネクタ] を選択して、[home_mcp] をオンに切り替えます。

詳細については、Claude Platform のドキュメントをご覧ください。

OpenClaw

OAuth 認証を使用してリモート SSE トランスポートに接続するように OpenClaw を構成します。

構成パッチの 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"
        }
      }
    }
  }
}

ターミナルで構成パッチを適用します。
```
openclaw config patch --stdin
```
OpenClaw ゲートウェイを再起動します。
```
openclaw gateway restart
```
認証フローを開始します。
```
openclaw mcp login home_mcp
```
生成された認証 URL に従ってログインし、アクセス権を付与します。

詳細については、OpenClaw のドキュメントをご覧ください。

認識済みの人物に関する同意

Home MCP で認識済みの人物のデータにアクセスするには、ユーザーがこの機能に別途明示的に同意する必要があります。

前提条件

同意を付与するユーザーは、Google Home ストラクチャの管理者である必要があります。
お客様のストラクチャに、対応する Google Nest カメラまたはドアホンが 1 台以上あり、有効な Google Home Premium の定期購入を利用していて、各カメラまたはドアホンで認識済みの人物の検出が有効になっている必要があります。
アプリケーションには、Google Cloud で作成された OAuth 2.0 クライアント ID が必要です。OAuth 2.0 クライアントをまだ作成していない場合は、AI クライアントを構成するをご覧ください。

同意リンク

アプリケーションにアクセス権を付与するには、OAuth 2.0 クライアント ID と Home ストラクチャ ID でパーソナライズされた同意リンクにアクセスする必要があります。同意リンクを取得する方法は 2 つあります。

リンクを取得したら、そのリンクにアクセスして同意します。

エージェントがリンクを作成する

エージェントがすでに 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

接続と機能を確認する

クライアントを構成して認証したら、サーバー接続を確認します。

AI アシスタントまたはワークスペースセッションを起動します。
アクティブな MCP サーバー接続を確認します（Antigravity で /mcp を実行するか、ツールリストを検査します）。
home_mcp が有効なツールとして表示されていることを確認します。
アシスタントにサンプルのプロンプトを発行して、さまざまな機能をテストします。
- エンティティの検出: 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?
クライアントからプロンプトが表示されたら、ツールの実行権限を付与します。AI アシスタントはリアルタイムの状態データを取得でき、すべての回答は家のテレメトリーに基づきます。

サポート

Home MCP の開発サポートについては、デベロッパー向けスマートホームヘルプコミュニティをご覧ください。コミュニティでは、質問を投稿してサポートを受けたり、以前に投稿された質問を検索して、自分の質問に対する回答がすでに投稿されていないか確認したりできます。

MCP のバグや機能リクエストを提出するには、公開バグトラッカーにアクセスしてください。

既知の問題

利用資格の適用 - Home MCP へのアクセスは、Google Home Premium Advanced サブスクリプションを持つユーザーに制限する必要があります。現在、Google Nest Aware Plus の定期購入者が Home MCP にアクセスできるバグが発生しています。Google はこの事象の解決に取り組んでおり、近日中に修正をリリースする予定です。
トレイトのテスト - エージェントに幅広い機能を提供するため、試験運用版としてマークされたトレイトがいくつか含まれています。これらの試験運用版のトレイトが想定どおりに動作しない場合があります。その場合は、公開 Issue Tracker を使用して報告してください。
レイテンシ - Home MCP で想定よりもレイテンシが長くなることがあります。Google は現在、最適化に取り組んでいます。今後のリリースでレイテンシが改善される予定です。

近日提供予定

自動化 - 現時点では、Home MCP を使用した自動化の作成と管理はサポートされていません。現在、この機能の開発に取り組んでおり、今後のリリースで自動化のサポートをリリースする予定です。

Google Home MCP サーバー コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

warning 警告:

概要

中核となる機能

前提条件

MCP サーバーを構成する

Google Cloud プロジェクトを作成する

Home API を有効にする

OAuth 同意と認証情報を構成する

AI クライアントを構成する

プロンプトを使用した自動設定

手動設定

Antigravity

Claude

OpenClaw

認識済みの人物に関する同意

前提条件

同意リンク

エージェントがリンクを作成する

リンクを作成する

接続と機能を確認する

サポート

既知の問題

近日提供予定

Google Home MCP サーバー

警告: