MCP Reference: gmailmcp.googleapis.com

Dies ist ein MCP-Server, der von der Gmail API bereitgestellt wird. Der Server bietet Tools für Entwickler, um LLM-Anwendungen auf Gmail aufzubauen.

Ein MCP-Server (Model Context Protocol) 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 verstehen kann.

Server einrichten

Sie müssen den Gmail-MCP-Server vor der Verwendung konfigurieren. Weitere Informationen zur Verwendung von Remote-MCP-Servern von Google und Google Cloud finden Sie unter Übersicht über Google Cloud-MCP-Server.

Serverendpunkte

Ein MCP-Dienstendpunkt ist die Netzwerkadresse und Kommunikationsschnittstelle (in der Regel eine URL) des MCP-Servers, über den eine KI-Anwendung (der Host für den MCP-Client) eine sichere, standardisierte Verbindung herstellt. Er ist der Ansprechpartner für das LLM, um Kontext anzufordern, ein Tool aufzurufen oder auf eine Ressource zuzugreifen. Google-MCP-Endpunkte können global oder regional sein.

Der MCP-Server der Gmail API hat den folgenden globalen MCP-Endpunkt:

  • https://gmailmcp.googleapis.com/mcp/v1

MCP-Tools

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

Tools

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

MCP-Tools
create_draft

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

Dieses Tool verwendet Empfängeradressen, einen Betreff und einen Nachrichtentext als Eingabe. Es gibt die ID des erstellten Gmail-Entwurfs zurück.
list_drafts

Listet E‑Mail-Entwürfe aus dem Gmail-Konto des authentifizierten Nutzers auf.

Dieses Tool kann Entwürfe anhand eines Anfragestrings filtern und unterstützt die Paginierung. Es gibt eine Liste von Entwürfen zurück, 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 Nachrichten.
search_threads

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

Dieses Tool kann Threads anhand eines Anfragestrings filtern und unterstützt die Paginierung. Es gibt eine Liste von Threads zurück, einschließlich ihrer IDs und zugehörigen Nachrichten. Jede zugehörige Nachricht enthält Details wie einen Ausschnitt des Inhalts der Nachricht, den Betreff, den Absender, die Empfänger usw. Die vollständigen Inhalte der Nachricht werden von diesem Tool nicht zurückgegeben. Verwenden Sie bei Bedarf das Tool „get_thread“ mit einer Thread-ID, um den vollständigen Inhalt der Nachricht abzurufen.
label_thread

Fügt einem gesamten Thread im Gmail-Konto des authentifizierten Nutzers Labels hinzu. Diese Aktion betrifft alle Nachrichten, die sich derzeit im Thread befinden, und alle zukünftigen Nachrichten, die hinzugefügt werden.

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

Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels, um die verfügbaren Labels und ihre IDs zu ermitteln.
unlabel_thread Entfernt Labels aus einem gesamten Thread im Gmail-Konto des authentifizierten Nutzers. Wenn Sie sich nicht sicher sind, welche Thread-ID Sie verwenden sollen, verwenden Sie zuerst das Tool search_threads. Wenn Sie sich nicht sicher sind, welche ID ein Nutzerlabel hat, verwenden Sie zuerst das Tool list_labels.
list_labels Listet alle benutzerdefinierten Labels auf, die im Gmail-Konto des authentifizierten Nutzers verfügbar sind. Verwenden Sie dieses Tool, um die id eines Nutzerlabels zu 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 die verfügbaren 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 die verfügbaren Labels und ihre IDs zu ermitteln.
create_label Erstellt ein neues Label im Gmail-Konto des authentifizierten Nutzers.

MCP-Tool-Spezifikationen abrufen

Verwenden Sie die Methode tools/list, um die MCP-Tool-Spezifikationen für alle Tools auf einem MCP-Server abzurufen. 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/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'