MCP Tools Reference: gmailmcp.googleapis.com

Outil : get_thread

Récupère un fil de discussion spécifique à partir du compte Gmail de l'utilisateur authentifié, y compris une liste de ses messages.

Le paramètre facultatif messageFormat contrôle le format des messages renvoyés. Par défaut (ou avec FULL_CONTENT), il renvoie le contenu complet des messages. Utilisez MINIMAL pour n'inclure que l'objet et l'extrait (à l'exclusion du corps). Utilisez METADATA_ONLY pour n'inclure que les métadonnées de base (ID de message, ID de fil de discussion, libellés, code temporel et estimation de la taille).

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

Requête curl 
curl --location 'https://gmailmcp.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": "get_thread",
    "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 GetThread.

GetThreadRequest

Représentation JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Champs
threadId

string

Obligatoire. Identifiant unique du fil de discussion à récupérer.
messageFormat

enum (MessageFormat)

Facultatif. Spécifie le format des messages renvoyés dans le fil de discussion. La valeur par défaut est FULL_CONTENT. Remarque : Le format MINIMAL renvoie l'ID, l'extrait, l'objet, l'expéditeur, le destinataire, le destinataire en copie, la date et les ID de libellé. Le format METADATA_ONLY renvoie l'ID, l'expéditeur, le destinataire, le destinataire en copie, la date et les ID de libellé. FULL_CONTENT renvoie l'ID, l'extrait, l'objet, l'expéditeur, le destinataire, le destinataire en copie, la date, les ID de libellé, les ID de pièce jointe, le corps en texte brut, le corps en HTML et les pièces jointes.

MessageFormat

Enum permettant de contrôler le niveau de détail des messages dans le fil de discussion.

Enums
MESSAGE_FORMAT_UNSPECIFIED La valeur par défaut est FULL_CONTENT.
MINIMAL Renvoie des extraits de message et des en-têtes clés (Objet, De, À, Cc, Date).
FULL_CONTENT Renvoie toutes les informations de "MINIMAL" ainsi que le contenu complet du corps de chaque message.
METADATA_ONLY Métadonnées uniquement : n'inclut pas l'objet, l'extrait, le corps ni les noms de fichiers des pièces jointes.

Schéma de sortie

Fil de discussion contenant une liste de messages.

Thread

Représentation JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Champs
id

string

Identifiant unique du fil de discussion.
messages[]

object (Message)

Liste des messages du fil de discussion, classés par ordre chronologique.

Message

Représentation JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
Champs
id

string

Identifiant unique du message.
snippet

string

Extrait du corps du message.
subject

string

Objet du message extrait des en-têtes :
sender

string

Adresse e-mail de l'expéditeur.
toRecipients[]

string

Adresses e-mail des destinataires.
ccRecipients[]

string

Adresses e-mail des destinataires en copie.
date

string

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

string

Contenu complet du corps, renseigné uniquement si MessageFormat était FULL_CONTENT.
attachmentIds[]

string

Uniquement en sortie. ID de pièce jointe, renseigné uniquement si MessageFormat était FULL_CONTENT.
htmlBody

string

Contenu HTML de l'e-mail, renseigné uniquement si MessageFormat était FULL_CONTENT.
attachments[]

object (AttachmentMetadata)

Uniquement en sortie. Pièces jointes, renseignées uniquement si MessageFormat était FULL_CONTENT.
labelIds[]

string

ID des libellés associés au message. Inclut les ID des libellés utilisateur et des libellés système standards limités à INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT et CHAT.

AttachmentMetadata

Représentation JSON 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Champs
id

string

Uniquement en sortie. ID de la pièce jointe.
mimeType

string

Type MIME de la pièce jointe.
filename

string

Nom de fichier de la pièce jointe.

Annotations d'outil

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

Champs d'application des autorisations

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata