MCP Tools Reference: gmailmcp.googleapis.com

Tool: search_threads

Listet E-Mail-Threads aus dem Gmail-Konto des authentifizierten Nutzers auf.

Mit diesem Tool können Threads anhand einer Suchanfrage gefiltert werden. Außerdem wird die Paginierung unterstützt. Es gibt eine Liste von Threads zurück, einschließlich ihrer IDs und zugehörigen Nachrichten. Jede zugehörige Nachricht enthält Details wie einen Snippet des Nachrichtentexts, den Betreff, den Absender, die Empfänger usw. Die vollständigen Nachrichtentexte werden von diesem Tool nicht zurückgegeben. Verwenden Sie bei Bedarf das Tool „get_thread“ mit einer Thread-ID, um den vollständigen Nachrichtentext abzurufen.

Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um das MCP-Tool search_threads aufzurufen.

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": "search_threads",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für SearchThreads RPC.

SearchThreadsRequest

JSON-Darstellung 
{

  "pageSize": integer

  "pageToken": string

  "query": string

  "includeTrash": boolean
}
Felder

Union-Feld _page_size.

Für _page_size ist nur einer der folgenden Werte zulässig:
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Threads. Wenn nichts anderes angegeben wird, wird der Wert standardmäßig auf 20 gesetzt. Der maximal zulässige Wert beträgt 50.

Union-Feld _page_token.

Für _page_token ist nur einer der folgenden Werte zulässig:
pageToken

string

Optional. Seitentoken zum Abrufen einer bestimmten Ergebnisseite in der Liste. Lassen Sie das Feld leer, um die erste Seite abzurufen.

Union-Feld _query.

Für _query ist nur einer der folgenden Werte zulässig:
query

string

Optional. Eine Suchanfrage zum Filtern der Threads im selben Format wie in der Gmail-Suchleiste. Wenn sie nicht angegeben wird, werden alle Threads aufgelistet (Spam und Papierkorb sind standardmäßig ausgeschlossen). Wichtige Operatoren: from: - Nachrichten von einem bestimmten Absender. to: - Nachrichten, die an einen bestimmten Empfänger gesendet wurden. subject: - Nachrichten mit bestimmten Wörtern im Betreff. – Nachrichten, die bestimmte Wörter im Text oder Betreff enthalten. is:unread – Ungelesene Nachrichten. is:starred – Nachrichten mit Stern. has:attachment – Nachrichten mit Anhängen. after:JJJJ/MM/TT – Nachrichten, die nach einem bestimmten Datum gesendet wurden. before:JJJJ/MM/TT – Nachrichten, die vor einem bestimmten Datum gesendet wurden. newer_than:

 Examples:
 "subject:OneMCP Update"
 "from:gduser1@workspacesamples.dev"
 "to:gduser2@workspacesamples.dev AND newer_than:7d"
 "project proposal has:attachment"
 "is:unread"

Union-Feld _include_trash.

Für _include_trash ist nur einer der folgenden Werte zulässig:
includeTrash

boolean

Optional. Entwürfe aus dem Papierkorb in die Ergebnisse einbeziehen. Die Standardeinstellung ist „false“.

Ausgabeschema

Antwortnachricht für SearchThreads RPC.

SearchThreadsResponse

JSON-Darstellung 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string
}
Felder
threads[]

object (Thread)

Liste der Thread-Zusammenfassungen.
nextPageToken

string

Ein Token, das in einem nachfolgenden Aufruf verwendet werden kann, um die nächste Seite mit Threads abzurufen. Ist nur vorhanden, wenn es weitere Ergebnisse gibt.

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
}
Felder
id

string

Die eindeutige ID der Nachricht.
snippet

string

Snippet des Nachrichtentexts.
subject

string

Der Betreff der Nachricht, der aus den Headern extrahiert wurde:
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, nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.

Toolanmerkungen

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