MCP Tools Reference: people.googleapis.com

工具：search_directory_people

在您组织的 Google Workspace 目录中搜索人员。此功能专为 Google Workspace 账号（供企业、学校和其他组织使用）而设，不适用于个人 Google 账号。

必须遵守的重要规则：

  • 如果此工具返回多个结果，您应向用户显示这些结果，并提示用户明确要使用哪个结果，然后再继续操作。

  • 在未获得用户明确确认的情况下，严禁将此工具的输出传递给其他工具（例如发送电子邮件、创建草稿、创建活动等）。

  • 即使只找到一个人物结果，您也必须向用户显示找到的人物详细信息，并提示用户验证此人是否是预期人物，然后才能继续执行后续步骤。

  • 如果此工具未返回任何结果，请改用 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

对方的账号电子邮件地址。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌