MCP Tools Reference: people.googleapis.com

ツール: search_contacts

ユーザーの連絡先を検索します。

重要なルール:

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

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

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

次のサンプルは、curl を使用して search_contacts 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_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

SearchContacts のリクエスト メッセージ。

SearchContactsMcpRequest

JSON 表現 
{
  "query": string,
  "maxResults": integer
}
フィールド
query

string

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

integer

結果の最大数。デフォルトは 10 で、許容最大値は 30 です。

出力スキーマ

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

SearchContactsMcpResponse

JSON 表現 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
フィールド
results[]

object (SearchContactsResult)

クエリに一致した連絡先のリスト。

SearchContactsResult

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

string

連絡先の表示名。
email

string

連絡先のアカウントのメールアドレス。

ツールのアノテーション

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