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.

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

Curl-Anfrage
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--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 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.

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
}
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 E-Mail-Adressen von Empfängern.

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, nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌