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 Entwürfe anhand einer Suchanfrage gefiltert werden. Außerdem wird die Paginierung unterstützt. Es gibt eine Liste von Entwürfen zurück, einschließlich ihrer IDs und Betreffzeilen.

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

Eingabeschema

Anfragenachricht für ListDrafts RPC.

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 Aufruf von list_drafts empfangen wurde, um die nächste Ergebnisseite abzurufen. 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 Entwürfe im selben Format wie in der Gmail-Suchleiste. Wenn das Feld leer gelassen wird, werden alle Entwürfe aufgelistet (Spam und Papierkorb werden 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 Textkörper 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"

Ausgabeschema

Antwortnachricht für ListDrafts RPC.

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. Ist nur vorhanden, wenn es weitere Ergebnisse gibt.

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 Entwurfsressource.
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 den Headern extrahiert wurden.
ccRecipients[]

string

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

string

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

string

Textkörper im Nur-Text-Format, falls verfügbar.
date

string

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

Toolanmerkungen

Destruktiv: ❌ | Idempotent: ❌ | Schreibgeschützt: ❌ | Offene Welt: ❌