MCP Tools Reference: gmailmcp.googleapis.com

Outil : list_labels

Liste tous les libellés définis par l'utilisateur disponibles dans le compte Gmail de l'utilisateur authentifié. Utilisez cet outil pour découvrir le id d'un libellé utilisateur avant d'appeler label_thread, unlabel_thread, label_message ou unlabel_message. Les libellés système ne sont pas renvoyés par cet outil, mais peuvent être utilisés avec leurs ID connus : "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".

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

Requête curl 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_labels",
    "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 l'RPC ListLabels.

ListLabelsRequest

Représentation JSON 
{

  "pageSize": integer

  "pageToken": string
}
Champs

Champ d'union _page_size.

_page_size ne peut être qu'un des éléments suivants :
pageSize

integer

Facultatif. Nombre maximal de libellés à renvoyer.

Champ d'union _page_token.

_page_token ne peut être qu'un des éléments suivants :
pageToken

string

Facultatif. Jeton de page permettant de récupérer une page spécifique de résultats dans la liste.

Schéma de sortie

Message de réponse pour le RPC ListLabels.

ListLabelsResponse

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

object (Label)

Liste des libellés utilisateur dans le compte de l'utilisateur.
nextPageToken

string

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

Libellé

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

string

Identifiant unique du libellé.
name

string

Nom d'affichage du libellé, lisible par l'humain.

Annotations d'outils

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