MCP Tools Reference: gmailmcp.googleapis.com

Tool: create_draft

Erstellt einen neuen E‑Mail-Vorschlag im Gmail-Konto des authentifizierten Nutzers.

Für dieses Tool werden Empfängeradressen, ein Betreff und der Nachrichtentext als Eingaben verwendet. Gibt die ID des erstellten Gmail-Entwurfs zurück. Wenn der Entwurf als Antwort auf eine vorhandene Nachricht erstellt wird, sollte die ID der ursprünglichen Nachricht im Feld „replyToMessageId“ an das Tool übergeben werden. Das Erstellen von Nachrichtenentwürfen mit Anhängen wird noch nicht unterstützt.

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

Eingabeschema

Anfragenachricht für den RPC „CreateDraft“.

CreateDraftRequest

JSON-Darstellung 
{
  "to": [
    string
  ],
  "cc": [
    string
  ],
  "bcc": [
    string
  ],
  "subject": string,
  "body": string,
  "htmlBody": string,
  "replyToMessageId": string
}
Felder
to[]

string

Erforderlich. Die primären Empfänger des E‑Mail-Entwurfs. Jeder String MUSS eine gültige E‑Mail-Adresse im Klartext sein (z.B. „nutzer@beispiel.de“). Das Format „Name email@example.com“ wird von diesem Tool NICHT unterstützt.
cc[]

string

Optional. Die Empfänger einer Kopie des E‑Mail-Entwurfs. Jeder String MUSS eine gültige E‑Mail-Adresse im Klartext sein (z.B. „nutzer@beispiel.de“). Das Format „Name email@example.com“ wird von diesem Tool NICHT unterstützt.
bcc[]

string

Optional. Die Empfänger der Blindkopie des E‑Mail-Entwurfs. Jeder String MUSS eine gültige E‑Mail-Adresse im Klartext sein (z.B. „nutzer@beispiel.de“). Das Format „Name email@example.com“ wird von diesem Tool NICHT unterstützt.
subject

string

Optional. Der Betreff der E‑Mail. Wenn kein Wert angegeben ist, wird der Standardwert „leer“ verwendet.
body

string

Optional. Der Haupttext des E‑Mail-Entwurfs. Wenn auch „html_body“ angegeben wird, wird dieses Feld als Nur-Text-Alternative behandelt.
htmlBody

string

Der HTML-Inhalt des E-Mail-Entwurfs. Falls angegeben, wird diese als Rich-Text-Version der E‑Mail verwendet.
replyToMessageId

string

Optional. Die ID der Nachricht, auf die geantwortet werden soll. Falls angegeben, wird diese als „Antworten an“-Nachrichten-ID für den E-Mail-Entwurf verwendet und die body und html_body werden an den ursprünglichen Inhalt der Nachricht angehängt.

Ausgabeschema

Details eines Entwurfs.

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“: ❌