MCP Tools Reference: gmailmcp.googleapis.com

Tool: get_thread

Ruft einen bestimmten E‑Mail-Thread aus dem Gmail-Konto des authentifizierten Nutzers ab, einschließlich einer Liste der Nachrichten im Thread.

Das folgende Beispiel zeigt, wie Sie das MCP-Tool get_thread mit curl aufrufen.

Curl-Anfrage 
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
}'

Eingabeschema

Anfragenachricht für GetThread RPC.

GetThreadRequest

JSON-Darstellung 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Felder
threadId

string

Erforderlich. Die eindeutige ID des abzurufenden Threads.
messageFormat

enum (MessageFormat)

Optional. Gibt das Format der Nachrichten an, die im Thread zurückgegeben werden. Die Standardeinstellung ist FULL_CONTENT. Hinweis: Wenn Sie Textkörper oder Anhänge benötigen, verwenden Sie FULL_CONTENT. Bei Verwendung von MINIMAL werden die Felder plaintext_body und attachment_ids nicht ausgefüllt. Wenn Sie sich nicht sicher sind, welches Format Sie verwenden sollen, verwenden Sie das Standardverhalten mit FULL_CONTENT.

MessageFormat

Enum zur Steuerung des Detaillierungsgrads für Nachrichten im Thread.

Enums
MESSAGE_FORMAT_UNSPECIFIED Die Standardeinstellung ist FULL_CONTENT.
MINIMAL Gibt Nachrichtenschnipsel und wichtige Header zurück (Betreff, Von, An, Cc, Datum).
FULL_CONTENT Gibt alle Informationen in „MINIMAL“ sowie den vollständigen Textkörper jeder Nachricht zurück.

Ausgabeschema

Thread mit einer Liste von Nachrichten.

Thread

JSON-Darstellung 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Felder
id

string

Die eindeutige ID des Threads.
messages[]

object (Message)

Eine Liste von Nachrichten im Thread, chronologisch geordnet.

Nachricht

JSON-Darstellung 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Felder
id

string

Die eindeutige ID der Nachricht.
snippet

string

Schnipsel des Nachrichtentextes.
subject

string

Der aus den Headern extrahierte Betreff der Nachricht.
sender

string

E‑Mail-Adresse des Absenders.
toRecipients[]

string

E‑Mail-Adressen der Empfänger.
ccRecipients[]

string

E‑Mail-Adressen der Cc-Empfänger.
date

string

Datum der Nachricht im ISO 8601-Format (JJJJ-MM-TT).
plaintextBody

string

Vollständiger Textkörper, wird nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.
attachmentIds[]

string

Nur Ausgabe. Die Anhänge-IDs werden nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.

Tool-Annotationen

Destruktiv: ❌ | Idempotent: ✅ | Schreibgeschützt: ✅ | Offene Welt: ❌