MCP Tools Reference: gmailmcp.googleapis.com

Tool: get_message

Ruft eine bestimmte E‑Mail-Nachricht aus dem Gmail-Konto des authentifizierten Nutzers anhand ihrer eindeutigen Nachrichten-ID ab.

Mit diesem Tool können Sie eine einzelne E‑Mail prüfen, wenn Sie bereits ihre Nachrichten-ID kennen. Wenn der Nutzer eine bestimmte E-Mail im Detail lesen, den genauen Wortlaut einer Nachricht prüfen oder die Metadaten von Anhängen für eine einzelne E-Mail untersuchen möchte, ist dies das richtige Tool. Es ist nicht geeignet, um ganze Unterhaltungen abzurufen oder Diskussionsthreads mit Hin- und Her-Antworten anzusehen. Verwenden Sie stattdessen das Tool „get_thread“. Wichtige Indikatoren sind, ob der Nutzer nach dem vollständigen Inhalt einer bestimmten Nachrichten-ID fragt, die von einer vorherigen Suche zurückgegeben wurde, oder ob in der Anfrage eine bestimmte einzelne E‑Mail anstelle eines gesamten Threads untersucht werden soll. Beispielhafte Nutzerprompts: „Get the full text of message ID 18f123456789abcd.“ (Rufe den vollständigen Text der Nachricht mit der ID 18f123456789abcd ab.) „Lies die letzte Nachricht in diesem Thread von Anna vor.“ und „Wie heißen die Anhänge in der E‑Mail, die ich gerade von der Personalabteilung erhalten habe?“

Der optionale Parameter messageFormat steuert das Format der zurückgegebenen Nachricht. Standardmäßig (oder mit FULL_CONTENT) wird der vollständige Inhalt der Nachricht zurückgegeben. Verwenden Sie MINIMAL, um nur Betreff und Snippet (ohne Textkörper) einzuschließen. Verwenden Sie METADATA_ONLY, um nur grundlegende Metadaten einzuschließen (Nachrichten-ID, Thread-ID, Labels, Zeitstempel und geschätzte Größe).

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

Eingabeschema

Anfragenachricht für den RPC „GetMessage“.

GetMessageRequest

JSON-Darstellung 
{
  "messageId": string,
  "messageFormat": enum (MessageFormat)
}
Felder
messageId

string

Erforderlich. Die eindeutige ID der abzurufenden Nachricht.
messageFormat

enum (MessageFormat)

Optional. Gibt das Format der zurückgegebenen Nachricht an. Die Standardeinstellung ist FULL_CONTENT.

MessageFormat

Enumeration zur Steuerung der Detailgenauigkeit von Nachrichten im Thread.

Enums
MESSAGE_FORMAT_UNSPECIFIED Die Standardeinstellung ist FULL_CONTENT.
MINIMAL Gibt Nachrichtenschnipsel und wichtige Header (Betreff, Von, An, Cc, Datum) zurück.
FULL_CONTENT Gibt alle Informationen in „MINIMAL“ sowie den vollständigen Inhalt jeder Nachricht zurück.
METADATA_ONLY Nur Metadaten: Betreff, Snippet, Text und Dateinamen von Anhängen sind nicht enthalten.

Ausgabeschema

Nachricht in einem Thread.

Nachricht

JSON-Darstellung 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ],
  "htmlBody": string,
  "attachments": [
    {
      object (AttachmentMetadata)
    }
  ],
  "labelIds": [
    string
  ]
}
Felder
id

string

Die eindeutige ID der Nachricht.
snippet

string

Snippet des Nachrichtentexts.
subject

string

Der aus Headern extrahierte Betreff der Nachricht:
sender

string

E‑Mail-Adresse des Absenders.
toRecipients[]

string

An die E-Mail-Adressen der Empfänger.
ccRecipients[]

string

E-Mail-Adressen der Cc-Empfänger.
date

string

Das Datum der Nachricht im ISO 8601-Format (JJJJ-MM-TT).
plaintextBody

string

Vollständiger Textinhalt, wird nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.
attachmentIds[]

string

Nur Ausgabe. Die Anhänge-IDs werden nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.
htmlBody

string

Der HTML-Inhalt der E-Mail. Wird nur ausgefüllt, wenn MessageFormat FULL_CONTENT ist.
attachments[]

object (AttachmentMetadata)

Nur Ausgabe. Die Anhänge werden nur ausgefüllt, wenn MessageFormat FULL_CONTENT war.
labelIds[]

string

Die IDs der Labels, die an die Nachricht angehängt sind. Enthält IDs von Nutzerlabels und Standard-Systemlabels, die auf INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT beschränkt sind.

AttachmentMetadata

JSON-Darstellung 
{
  "id": string,
  "mimeType": string,
  "filename": string
}
Felder
id

string

Nur Ausgabe. Die ID des Anhangs.
mimeType

string

Der MIME-Typ des Anhangs.
filename

string

Der Dateiname des Anhangs.

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