MCP Tools Reference: gmailmcp.googleapis.com

Tool: list_drafts

Listet E‑Mail-Entwürfe aus dem Gmail-Konto des authentifizierten Nutzers auf.

Mit diesem Tool können Sie Entwürfe anhand eines Abfragestrings filtern und die Paginierung wird unterstützt. Es wird eine Liste von Entwürfen zurückgegeben, einschließlich ihrer IDs und Betreffe. Mit page_token können die Ergebnisse paginiert werden. Wenn Sie nachfolgende Ergebnisseiten abrufen möchten, verwenden Sie das page_token, das in der vorherigen Antwort zurückgegeben wurde.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_drafts 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": "list_drafts",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für den RPC „ListDrafts“.

ListDraftsRequest

JSON-Darstellung 
{

  "pageSize": integer

  "pageToken": string

  "query": string
}
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 Entwürfe. 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. Ein Token, das von einem vorherigen list_drafts-Aufruf empfangen wurde, um die nächste Ergebnisseite abzurufen. Lassen Sie das Feld leer, um die erste Seite abzurufen. Dieser Parameter wird hauptsächlich für die Paginierung verwendet, um Ergebnisse abzurufen, die beim vorherigen ListDraft-Aufruf nicht berücksichtigt wurden. Das ist besonders nützlich, wenn die Anzahl der Entwürfe, die der Abfrage entsprechen, das Limit für „page_size“ überschreitet.

Union-Feld _query.

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

string

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

Ein Leerzeichen oder ein Bindestrich (-) trennt eine Zahl, ein Punkt (.) ist ein Dezimaltrennzeichen. Beispiel: 01.2047-100 wird als zwei Zahlen betrachtet, nämlich 01.2047 und 100.

Hinweis: Wenn wir sichergehen möchten, dass alle Entwürfe für die Anfrage zurückgegeben werden, können wir die Ergebnisse paginieren, indem wir das Tool wiederholt aufrufen, bis die Antwort eine leere Liste von Entwürfen enthält.

Ausgabeschema

Antwortnachricht für den RPC „ListDrafts“.

ListDraftsResponse

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

object (Draft)

Liste der Entwürfe.
nextPageToken

string

Ein Token, das in einem nachfolgenden Aufruf verwendet werden kann, um die nächste Seite mit Entwürfen abzurufen. Wenn die Anzahl der Entwürfe, die der Anfrage entsprechen, das Limit für „page_size“ überschreitet, enthält die Antwort ein next_page_token. Wenn Sie die nächste Ergebnisseite abrufen möchten, übergeben Sie dieses Token im Feld page_token des nächsten ListDraftsRequest.

Entwurf

JSON-Darstellung 
{
  "id": string,
  "subject": string,
  "threadId": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "bccRecipients": [
    string
  ],
  "plaintextBody": string,
  "date": string
}
Felder
id

string

Die eindeutige Kennung der Ressourcenversion als Entwurf.
subject

string

Die Betreffzeile der Entwurfsnachricht.
threadId

string

Die ID des Threads, zu dem dieser Entwurf gehört.
toRecipients[]

string

Liste der E‑Mail-Adressen der Empfänger im Feld „An“, die aus Headern extrahiert wurden.
ccRecipients[]

string

Liste der E‑Mail-Adressen der „Cc“-Empfänger, die aus Headern extrahiert wurden.
bccRecipients[]

string

Liste der E‑Mail-Adressen der „Bcc“-Empfänger, die aus Headern extrahiert wurden.
plaintextBody

string

Nur-Text-Inhalt des Textkörpers, falls verfügbar.
date

string

Das Datum des Entwurfs im ISO 8601-Format (JJJJ-MM-TT).

Tool-Annotationen

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