MCP Tools Reference: gmailmcp.googleapis.com

Outil : create_draft

Crée un brouillon d'e-mail dans le compte Gmail de l'utilisateur authentifié.

Cet outil prend comme entrées les adresses des destinataires, un objet et le contenu du corps du message. Il renvoie l'ID du brouillon Gmail créé. Si le brouillon est créé en réponse à un message existant, l'ID du message d'origine doit être transmis à l'outil dans le champ replyToMessageId. La création de brouillons avec des pièces jointes n'est pas encore possible.

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

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": "create_draft",
    "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 le RPC CreateDraft.

CreateDraftRequest

Représentation JSON 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Champs
to[]

string

Obligatoire. Destinataires principaux du brouillon d'e-mail. Chaque chaîne DOIT être une adresse e-mail simple valide (par exemple, "user@example.com"). Le format "Name email@example.com" N'EST PAS accepté par cet outil.
cc[]

string

Facultatif. Destinataires en copie carbone du brouillon d'e-mail. Chaque chaîne DOIT être une adresse e-mail simple valide (par exemple, "user@example.com"). Le format "Name email@example.com" N'EST PAS accepté par cet outil.
bcc[]

string

Facultatif. Destinataires en copie carbone invisible du brouillon d'e-mail. Chaque chaîne DOIT être une adresse e-mail simple valide (par exemple, "user@example.com"). Le format "Name email@example.com" N'EST PAS accepté par cet outil.
subject

string

Facultatif. Objet de l'e-mail. Par défaut, la valeur est vide si elle n'est pas fournie.
body

string

Facultatif. Contenu principal du corps du brouillon d'e-mail. Si html_body est également fourni, ce champ est traité comme l'alternative en texte brut.
htmlBody

string

Contenu HTML du brouillon d'e-mail. Si cette valeur est fournie, elle sera utilisée comme version au format texte enrichi de l'e-mail.
replyToMessageId

string

Facultatif. ID du message auquel répondre. Si cette valeur est fournie, elle sera utilisée comme ID du message de réponse pour le brouillon d'e-mail, et les valeurs body et html_body seront ajoutées au corps du message d'origine.

Schéma de sortie

Détails d'un brouillon.

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 de message.
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 : ❌