MCP Tools Reference: people.googleapis.com

Ferramenta: search_directory_people

Pesquise pessoas no diretório do Google Workspace da sua organização. Esse recurso é exclusivo para contas do Google Workspace (usadas por empresas, escolas e outras organizações) e não está disponível para Contas do Google pessoais.

REGRAS IMPORTANTES A SEGUIR:

  • Se essa ferramenta retornar vários resultados, apresente-os ao usuário e peça esclarecimentos sobre qual resultado usar antes de continuar.

  • É estritamente proibido transmitir a saída dessa ferramenta para outra (por exemplo, enviar um e-mail, criar um rascunho, criar um evento etc.) sem a confirmação explícita do usuário.

  • Mesmo que apenas um resultado seja encontrado, você precisa apresentar os detalhes da pessoa ao usuário e pedir que ele verifique se é a pessoa certa antes de continuar.

  • Se essa ferramenta não retornar resultados, use a ferramenta search_contacts.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta search_directory_people MCP.

Solicitação 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
}'

Esquema de entrada

Mensagem de solicitação para SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Representação JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Campos
query

string

String de consulta a ser pesquisada.
pageSize

integer

Tamanho da página. O padrão é 10 e o valor máximo permitido é 500.
pageToken

string

Token da página.
sources[]

enum (DirectorySourceType)

Fontes de diretório a serem retornadas. O padrão é DOMAIN_PROFILE se não for definido.

DirectorySourceType

Tipos enumerados
DOMAIN_PROFILE Perfil do domínio do Google Workspace.
DOMAIN_CONTACT Contato compartilhado do domínio do Google Workspace.

Esquema de saída

Mensagem de resposta para SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Representação JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Campos
results[]

object (SearchDirectoryResult)

A lista de pessoas que corresponderam à consulta.
nextPageToken

string

Um token para recuperar a próxima página de resultados.

SearchDirectoryResult

Representação JSON 
{
  "name": string,
  "email": string
}
Campos
name

string

O nome de exibição da pessoa.
email

string

O endereço de e-mail da conta da pessoa.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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