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 を使用して、特定の期間の過去の状態変更とイベントログをクエリします。

前提条件

ホーム 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. [作成] をクリックし、クライアント 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://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

手動設定

手動設定の手順については、ご希望の AI ツールを選択してください。

Antigravity

Google Antigravity は、CLI、IDE、デスクトップ環境全体で MCP サーバーの組み込み統合を提供します。

アプリケーション設定メニュー（[設定] > [詳細設定] > [カスタマイズ] > [MCP 設定を開く]）を開きます。

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 Connectors を開きます。
[+] をクリックし、[カスタムコネクタを追加] を選択します。
サーバーの URL（https://home.googleapis.com/mcp）を入力します。
[詳細設定] をクリックして、クライアント ID とクライアントシークレットを入力します。
[追加] をクリックし、ブラウザで 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 のドキュメントをご覧ください。

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

ホーム 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 のバグや機能リクエストを提出するには、公開バグトラッカーにアクセスしてください。

既知の問題

トレイトテスト - エージェントに最も幅広い機能を提供するために、試験運用としてマークされたトレイトがいくつか含まれています。これらの試験運用版の特性が想定どおりに動作しないシナリオが発生する可能性があります。その場合は、公開されている Issue Tracker を通じてご報告ください。
レイテンシ - Home MCP でレイテンシが想定より長くなることがあります。現在、Google では最適化に積極的に取り組んでいます。今後のリリースでレイテンシの改善が予定されています。

近日提供予定

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

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

warning 警告:

概要

中核となる機能

前提条件

MCP サーバーを構成する

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

Home API を有効にする

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

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

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

手動設定

Antigravity

Claude

OpenClaw

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

前提条件

同意リンク

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

リンクを作成する

接続と機能を確認する

サポート

既知の問題

近日提供予定

Google Home MCP サーバー

警告: