MCP Tools Reference: people.googleapis.com

Herramienta: search_contacts

Buscar los contactos del usuario

REGLAS IMPORTANTES QUE DEBES SEGUIR:

  • Si esta herramienta devuelve varios resultados, debes presentárselos al usuario y pedirle que aclare qué resultado usar antes de continuar.

  • Está estrictamente prohibido pasar el resultado de esta herramienta a otra (p.ej., enviar un correo electrónico, crear un borrador, crear un evento, etc.) sin la confirmación explícita del usuario.

  • Incluso si solo se encuentra el resultado de una persona, debes presentarle los detalles de la persona encontrada al usuario y pedirle que verifique que se trata de la persona deseada antes de continuar con otros pasos.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP search_contacts.

Solicitud de 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

Es el mensaje de solicitud de SearchContacts.

SearchContactsMcpRequest

Representación JSON 
{
  "query": string,
  "maxResults": integer
}
Campos
query

string

Cadena de consulta para buscar.
maxResults

integer

Cantidad máxima de resultados. El valor predeterminado es 10 y el valor máximo permitido es 30.

Esquema de salida

Es el mensaje de respuesta para SearchContacts.

SearchContactsMcpResponse

Representación JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Campos
results[]

object (SearchContactsResult)

Es la lista de contactos que coincidieron con la búsqueda.

SearchContactsResult

Representación JSON 
{
  "name": string,
  "email": string
}
Campos
name

string

Es el nombre visible del contacto.
email

string

Es la dirección de correo electrónico de la cuenta del contacto.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

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