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.

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

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_drafts",
    "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 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 à renvoyer. 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.

Champ d'union _query.

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

string

Facultatif. Chaîne de requête permettant de filtrer les brouillons, au même format que la barre de recherche Gmail. Si ce champ est omis, tous les brouillons (à l'exception du spam et de la corbeille par défaut) sont répertoriés. Opérateurs clés : from: - Messages provenant d'un expéditeur spécifique. to: - Messages envoyés à un destinataire spécifique. subject: - Messages contenant des mots spécifiques dans l'objet. - Messages contenant des mots spécifiques dans le corps ou l'objet. is:unread - Messages non lus. is:starred - Messages avec étoile. has:attachment - Messages avec pièces jointes. after:AAAA/MM/JJ - Messages envoyés après une date. before:AAAA/MM/JJ - Messages envoyés avant une date. newer_than:

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

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 pouvant être utilisé dans un appel ultérieur pour récupérer la page de brouillons suivante. Présent uniquement si d'autres résultats sont disponibles.

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