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 '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 になります。

出力スキーマ

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

SearchDirectoryPeopleMcpResponse

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

object (SearchDirectoryResult)

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

string

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

SearchDirectoryResult

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

string

ユーザーの表示名。
email

string

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

ツールのアノテーション

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