MCP Reference: gmailmcp.googleapis.com

Ein Model Context Protocol (MCP)-Server fungiert als Proxy zwischen einem externen Dienst, der einem Large Language Model (LLM) oder einer KI-Anwendung Kontext, Daten oder Funktionen bereitstellt. MCP-Server verbinden KI-Anwendungen mit externen Systemen wie Datenbanken und Webdiensten und übersetzen deren Antworten in ein Format, das die KI-Anwendung versteht.

MCP-Tools

Ein MCP-Tool ist eine Funktion oder ausführbare Funktion, die ein MCP-Server einem LLM oder einer KI-Anwendung zur Ausführung einer Aktion in der realen Welt zur Verfügung stellt.

Der MCP-Server „gmailmcp.googleapis.com“ hat die folgenden Tools:

MCP-Tools
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.
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 Suchstrings filtern und die Paginierung wird unterstützt. Es wird eine Liste von Entwürfen zurückgegeben, einschließlich ihrer IDs und Betreffe.
get_thread Ruft einen bestimmten E‑Mail-Thread aus dem Gmail-Konto des authentifizierten Nutzers ab, einschließlich einer Liste der zugehörigen Nachrichten.
search_threads

Listet E‑Mail-Konversationen aus dem Gmail-Konto des authentifizierten Nutzers auf.

Mit diesem Tool können Threads anhand eines Abfragestrings gefiltert werden. Außerdem wird die Paginierung unterstützt. Es wird eine Liste von Threads zurückgegeben, einschließlich ihrer IDs und zugehörigen Nachrichten. Jede zugehörige Nachricht enthält Details wie einen Ausschnitt des Nachrichtentexts, den Betreff, den Absender und die Empfänger. Beachten Sie, dass die vollständigen Nachrichtentexte von diesem Tool nicht zurückgegeben werden. Verwenden Sie das Tool „get_thread“ mit einer Thread-ID, um den vollständigen Nachrichtentext abzurufen, falls erforderlich.
label_thread

Fügt dem gesamten E-Mail-Verlauf im Gmail-Konto des authentifizierten Nutzers Labels hinzu. Dieser Vorgang wirkt sich auf alle Nachrichten aus, die sich derzeit im Thread befinden, und auf alle zukünftigen Nachrichten, die dem Thread hinzugefügt werden.

Wenn Sie sich nicht sicher sind, welche Thread-ID Sie verwenden sollen, verwenden Sie zuerst das search_threads-Tool.

Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels, um verfügbare Labels und ihre IDs zu ermitteln.
unlabel_thread Entfernt Labels aus einem gesamten E‑Mail-Verlauf im Gmail-Konto des authentifizierten Nutzers. Wenn Sie sich nicht sicher sind, welche Thread-ID Sie verwenden sollen, verwenden Sie zuerst das search_threads-Tool. Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das list_labels-Tool.
list_labels Listet alle benutzerdefinierten Labels auf, die im Gmail-Konto des authentifizierten Nutzers verfügbar sind. Mit diesem Tool können Sie die id eines Nutzerlabels ermitteln, bevor Sie label_thread, unlabel_thread, label_message oder unlabel_message aufrufen. Systemlabels werden von diesem Tool nicht zurückgegeben, können aber mit ihren bekannten IDs verwendet werden: „INBOX“, „TRASH“, „SPAM“, „STARRED“, „UNREAD“, „IMPORTANT“, „CHAT“, „DRAFT“, „SENT“.
label_message

Fügt einer bestimmten Nachricht im Gmail-Konto des authentifizierten Nutzers ein oder mehrere Labels hinzu.

Verwenden Sie Tools wie search_threads oder get_thread, um die Nachrichten-ID zu finden. Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels, um verfügbare Labels und ihre IDs zu ermitteln.
unlabel_message Entfernt ein oder mehrere Labels aus einer bestimmten Nachricht im Gmail-Konto des authentifizierten Nutzers. Verwenden Sie Tools wie search_threads oder get_thread, um die Nachrichten-ID zu finden. Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels, um verfügbare Labels und ihre IDs zu ermitteln.
create_label Erstellt ein neues Label im Gmail-Konto des authentifizierten Nutzers.

Spezifikationen für MCP-Tools abrufen

Wenn Sie die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abrufen möchten, verwenden Sie die Methode tools/list. Im folgenden Beispiel wird gezeigt, wie Sie mit curl alle Tools und ihre Spezifikationen auflisten, die derzeit auf dem MCP-Server verfügbar sind.

Curl-Anfrage 
curl --location 'https://gmailmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'