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 (sofern view nicht auf DRAFT_VIEW_METADATA_ONLY gesetzt ist). page_token kann verwendet werden, um die Ergebnisse zu paginieren. Wenn Sie nachfolgende Ergebnisseiten abrufen möchten, verwenden Sie das page_token, das in der vorherigen Antwort zurückgegeben wurde.

Mit dem Parameter view wird gesteuert, welche Felder in der Antwort ausgefüllt werden. Standardmäßig (oder mit DRAFT_VIEW_FULL) werden vollständige Inhalte zurückgegeben. Verwenden Sie DRAFT_VIEW_METADATA_ONLY, um sensible Inhalte wie Betreff und Textkörper auszuschließen.

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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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

  "view": enum (DraftView)
}
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 sicherstellen 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.

Union-Feld _view.

Für _view ist nur einer der folgenden Werte zulässig:
view

enum (DraftView)

Optional. Steuert die Felder, die für Entwürfe in der Entwurfsliste ausgefüllt werden. Standardmäßig (oder mit DRAFT_VIEW_FULL) wird der vollständige Inhalt zurückgegeben, der die Entwurfs-ID, die Thread-ID, „An“, „Cc“, „Bcc“, „Datum“, „Betreff“ und „Textkörper“ enthält. Verwenden Sie DRAFT_VIEW_METADATA_ONLY, um Betreff und Text auszuschließen.

DraftView

Enum zur Steuerung der Felder, die für Entwürfe in der ListDrafts-Antwort ausgefüllt werden.

Enums
DRAFT_VIEW_UNSPECIFIED Wird aus Gründen der Abwärtskompatibilität auf DRAFT_VIEW_FULL abgebildet.
DRAFT_VIEW_METADATA_ONLY Nur Metadaten: Enthält nicht „subject“, „plaintext_body“ und „html_body“.
DRAFT_VIEW_FULL Metadaten + nutzergenerierte Inhalte (Standardverhalten)

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,
  "htmlBody": 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).
htmlBody

string

Der HTML-Text des Entwurfs, falls verfügbar.

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.compose
  • https://www.googleapis.com/auth/gmail.readonly