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 passer à l'étape suivante.

  • 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 '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
}'

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 aucune valeur n'est définie, la valeur par défaut est DOMAIN_PROFILE.

DirectorySourceType

Enums
DOMAIN_PROFILE Profil de domaine Google Workspace.
DOMAIN_CONTACT Contact partagé du domaine Google Workspace.

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 d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication de monde ouvert : ❌

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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