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.

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 '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 : Si vous avez besoin du contenu du corps ou des pièces jointes, utilisez FULL_CONTENT. Lorsque vous utilisez MINIMAL, les champs plaintext_body et attachment_ids ne sont pas renseignés. Si vous ne savez pas quel format utiliser, fiez-vous au comportement par défaut en utilisant FULL_CONTENT.

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 messages 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.

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
  ]
}
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. Identifiants des pièces jointes, renseignés uniquement si MessageFormat était FULL_CONTENT.

Annotations d'outil

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