MCP Tools Reference: people.googleapis.com

Ferramenta: search_contacts

Pesquisar os contatos do usuário.

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.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta search_contacts 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_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem de solicitação para "SearchContacts".

SearchContactsMcpRequest

Representação JSON 
{
  "query": string,
  "maxResults": integer
}
Campos
query

string

String de consulta a ser pesquisada.
maxResults

integer

Número máximo de resultados. O padrão é 10 e o valor máximo permitido é 30.

Esquema de saída

Mensagem de resposta para "SearchContacts".

SearchContactsMcpResponse

Representação JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Campos
results[]

object (SearchContactsResult)

A lista de contatos que corresponderam à consulta.

SearchContactsResult

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

string

O nome de exibição do contato.
email

string

O endereço de e-mail da conta do contato.

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/contacts.readonly