MCP Tools Reference: people.googleapis.com

Herramienta: search_directory_people

Buscar personas en el directorio de Google Workspace de tu organización Esta función es exclusiva para las cuentas de Google Workspace (que usan empresas, instituciones educativas y otras organizaciones) y no está disponible para las Cuentas de Google personales.

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 se encuentra solo 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.

  • Si esta herramienta no muestra resultados, usa la herramienta search_contacts.

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

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

Esquema de entrada

Es el mensaje de solicitud para SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Representación JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Campos
query

string

Es la cadena de búsqueda.
pageSize

integer

Indica el tamaño de la página. El valor predeterminado es 10 y el valor máximo permitido es 500.
pageToken

string

Token de la página
sources[]

enum (DirectorySourceType)

Son las fuentes de directorios que se devolverán. Si no se configura, el valor predeterminado es DOMAIN_PROFILE.

Esquema de salida

Es el mensaje de respuesta de SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Representación JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Campos
results[]

object (SearchDirectoryResult)

Es la lista de personas que coincidieron con la búsqueda.
nextPageToken

string

Un token para recuperar los resultados de la página siguiente.

SearchDirectoryResult

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

string

El nombre visible de la persona.
email

string

Es la dirección de correo electrónico de la cuenta de la persona.

Anotaciones de herramientas

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