MCP Tools Reference: people.googleapis.com

Outil : search_directory_people

Recherchez des personnes dans l'annuaire Google Workspace de votre organisation. Cette fonctionnalité est exclusivement réservée aux comptes Google Workspace (utilisés par les entreprises, les établissements scolaires et d'autres organisations). Elle n'est pas disponible pour les comptes Google personnels.

RÈGLES IMPORTANTES À SUIVRE :

  • Si cet outil renvoie plusieurs résultats, vous devez les présenter à l'utilisateur et lui demander de préciser celui à utiliser avant de continuer.

  • Il vous est strictement interdit de transmettre la sortie de cet outil à un autre outil (par exemple, pour envoyer un e-mail, créer un brouillon, créer un événement, etc.) sans la confirmation explicite de l'utilisateur.

  • Même si un seul résultat de personne est trouvé, vous devez présenter les informations de la personne trouvée à l'utilisateur et l'inviter à vérifier qu'il s'agit bien de la personne recherchée avant de poursuivre.

  • Si cet outil ne renvoie aucun résultat, utilisez l'outil search_contacts.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP search_directory_people.

Requête 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
}'

Schéma d'entrée

Message de requête pour SearchDirectoryPeople.

SearchDirectoryPeopleMcpRequest

Représentation JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
Champs
query

string

Chaîne de requête à rechercher.
pageSize

integer

Taille de la page. La valeur par défaut est 10 et la valeur maximale autorisée est 500.
pageToken

string

Jeton de la page.
sources[]

enum (DirectorySourceType)

Sources de répertoire à renvoyer. Si ce champ n'est pas défini, la valeur par défaut est DOMAIN_PROFILE.

Schéma de sortie

Message de réponse pour SearchDirectoryPeople.

SearchDirectoryPeopleMcpResponse

Représentation JSON 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
Champs
results[]

object (SearchDirectoryResult)

Liste des personnes correspondant à la requête.
nextPageToken

string

Jeton permettant de récupérer la page de résultats suivante.

SearchDirectoryResult

Représentation JSON 
{
  "name": string,
  "email": string
}
Champs
name

string

Nom à afficher de la personne.
email

string

Adresse e-mail du compte de la personne.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌