MCP Tools Reference: people.googleapis.com

ツール: search_directory_people

組織の Google Workspace ディレクトリ内のユーザーを検索します。この機能は Google Workspace アカウント（企業、学校、その他の組織で使用）専用であり、個人の Google アカウントでは利用できません。

重要なルール:

  • このツールから複数の結果が返された場合は、ユーザーに結果を提示し、どの結果を使用するかを明確にするようユーザーに求める必要があります。

  • ユーザーの明示的な確認なしに、このツールの出力を別のツールに渡す（メールの送信、下書きの作成、予定の作成など）ことは固く禁じられています。

  • 人物の結果が 1 つしか見つからなかった場合でも、見つかった人物の詳細をユーザーに提示し、その人物が目的の人物であることを確認するようユーザーに促してから、次の手順に進む必要があります。

  • このツールで結果が返されない場合は、search_contacts ツールを使用します。

次のサンプルは、curl を使用して search_directory_people MCP ツールを呼び出す方法を示しています。

Curl リクエスト 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_directory_people",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

SearchDirectoryPeople に対するリクエスト メッセージ。

SearchDirectoryPeopleMcpRequest

JSON 表現 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
フィールド
query

string

検索するクエリ文字列。
pageSize

integer

ページサイズ。デフォルトは 10 で、許容最大値は 500 です。
pageToken

string

ページトークン。
sources[]

enum (DirectorySourceType)

返すディレクトリ ソース。設定しない場合、デフォルトは DOMAIN_PROFILE です。

DirectorySourceType

列挙型
DOMAIN_PROFILE Google Workspace ドメイン プロファイル。
DOMAIN_CONTACT Google Workspace ドメインの共有連絡先。

出力スキーマ

SearchDirectoryPeople に対するレスポンス メッセージ。

SearchDirectoryPeopleMcpResponse

JSON 表現 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
フィールド
results[]

object (SearchDirectoryResult)

クエリに一致したユーザーのリスト。
nextPageToken

string

結果の次のページを取得するためのトークン。

SearchDirectoryResult

JSON 表現 
{
  "name": string,
  "email": string
}
フィールド
name

string

ユーザーの表示名。
email

string

ユーザーのアカウントのメールアドレス。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/directory.readonly