MCP Tools Reference: gmailmcp.googleapis.com

Outil : list_drafts

Répertorie les brouillons d'e-mails du compte Gmail de l'utilisateur authentifié.

Cet outil peut filtrer les brouillons en fonction d'une chaîne de requête et est compatible avec la pagination. Il renvoie une liste de brouillons, y compris leurs ID et leurs objets. page_token peut être utilisé pour paginer les résultats. Pour récupérer les pages de résultats suivantes, utilisez le page_token renvoyé dans la réponse précédente.

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

Requête Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour la RPC ListDrafts.

ListDraftsRequest

Représentation JSON 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
Champs

Champ d'union _page_size.

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

integer

Facultatif. Nombre maximal de brouillons à afficher. Si aucune valeur n'est spécifiée, la valeur définie par défaut est 20. La valeur maximale autorisée est de 50.

Champ d'union _page_token.

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

string

Facultatif. Jeton reçu d'un appel list_drafts précédent pour récupérer la page de résultats suivante. Laissez ce champ vide pour récupérer la première page. Il est principalement utilisé pour la pagination afin de continuer à récupérer les résultats à partir de l'endroit où l'appel ListDraft précédent s'est arrêté, en particulier lorsque le nombre de brouillons correspondant à la requête dépasse la limite de page_size.

Champ d'union _query.

_query ne peut être qu'un des éléments suivants :
query

string

Exemples : "subject:OneMCP Update" "from:gduser1@workspacesamples.dev" "to:gduser2@workspacesamples.dev AND newer_than:7d" "project proposal has:attachment" "is:unread"

L'espace ou le tiret (-) permet de séparer deux nombres, tandis que le point (.) est utilisé comme séparateur décimal. Par exemple, 01.2047-100 représente deux nombres : 01.2047 et 100.

Remarque : Si vous souhaitez vous assurer que tous les brouillons de la requête sont renvoyés, vous pouvez paginer les résultats en effectuant des appels répétés à l'outil jusqu'à ce que la réponse contienne une liste vide de brouillons.

Schéma de sortie

Message de réponse pour la RPC ListDrafts.

ListDraftsResponse

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

object (Draft)

Liste des brouillons.
nextPageToken

string

Jeton qui peut être utilisé dans un appel ultérieur pour récupérer la page de brouillons suivante. Si le nombre de brouillons correspondant à la requête dépasse la limite de page_size, la réponse contient un next_page_token. Pour récupérer la page de résultats suivante, transmettez ce jeton dans le champ page_token de la requête ListDraftsRequest suivante.

Brouillon

Représentation JSON 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Champs
id

string

Identifiant unique de la ressource de brouillon.
subject

string

Objet du message brouillon.
threadId

string

ID du fil de discussion auquel appartient ce brouillon.
toRecipients[]

string

Liste des adresses e-mail des destinataires "À" extraites des en-têtes.
ccRecipients[]

string

Liste des adresses e-mail des destinataires "Cc" extraites des en-têtes.
bccRecipients[]

string

Liste des adresses e-mail des destinataires "Cci" extraites des en-têtes.
plaintextBody

string

Contenu du corps en texte brut, le cas échéant.
date

string

Date du brouillon au format ISO 8601 (AAAA-MM-JJ).

Annotations d'outil

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