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 zugehörigen Nachrichten.

Mit dem optionalen Parameter messageFormat wird das Format der zurückgegebenen Nachrichten gesteuert. Standardmäßig (oder mit FULL_CONTENT) wird der vollständige Inhalt von Nachrichten zurückgegeben. Verwenden Sie MINIMAL, um nur Betreff und Snippet (ohne Textkörper) einzuschließen. Verwenden Sie METADATA_ONLY, um nur grundlegende Metadaten einzuschließen (Nachrichten-ID, Thread-ID, Labels, Zeitstempel und geschätzte Größe).

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool get_thread aufrufen.

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

Eingabeschema

Anfragenachricht für den RPC „GetThread“

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: Das MINIMAL-Format gibt „id“, „snippet“, „subject“, „from“, „to“, „cc“, „date“ und „labelIds“ zurück. Beim Format METADATA_ONLY werden die Felder „id“, „from“, „to“, „cc“, „date“ und „labelIds“ zurückgegeben. FULL_CONTENT gibt „id“, „snippet“, „subject“, „from“, „to“, „cc“, „date“, „labelIds“, „attachmentIds“, „plaintextBody“, „htmlBody“ und „attachments“ zurück.

MessageFormat

Enumeration zur Steuerung der Detailgenauigkeit von Nachrichten im Thread.

Enums
MESSAGE_FORMAT_UNSPECIFIED Die Standardeinstellung ist FULL_CONTENT.
MINIMAL Gibt Nachrichtenschnipsel und wichtige Header (Betreff, Von, An, Cc, Datum) zurück.
FULL_CONTENT Gibt alle Informationen in „MINIMAL“ sowie den vollständigen Inhalt jeder Nachricht zurück.
METADATA_ONLY Nur Metadaten: Betreff, Snippet, Text und Dateinamen von Anhängen sind nicht enthalten.

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 der Nachrichten im Thread, chronologisch sortiert.

Nachricht

JSON-Darstellung 
{
  "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
  ]
}
Felder
id

string

Die eindeutige ID der Nachricht.
snippet

string

Snippet des Nachrichtentexts.
subject

string

Der aus Headern extrahierte Betreff der Nachricht:
sender

string

E‑Mail-Adresse des Absenders.
toRecipients[]

string

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

string

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

string

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

string

Vollständiger Textinhalt, 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.
htmlBody

string

Der HTML-Inhalt der E-Mail. Wird nur ausgefüllt, wenn MessageFormat FULL_CONTENT ist.
attachments[]

object (AttachmentMetadata)

Nur Ausgabe. Die Anhänge werden nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.
labelIds[]

string

Die IDs der Labels, die an die Nachricht angehängt sind. Enthält IDs von Nutzerlabels und Standard-Systemlabels, die auf INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT beschränkt sind.

AttachmentMetadata

JSON-Darstellung 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Felder
id

string

Nur Ausgabe. Die ID des Anhangs.
mimeType

string

Der MIME-Typ des Anhangs.
filename

string

Der Dateiname des Anhangs.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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