Gmail bietet einen Remote-MCP-Server (Model Context Protocol), über den KI-Agenten sicher mit Gmail-Daten interagieren können. Wenn Sie den Gmail-MCP-Server konfigurieren, können KI-Anwendungen wie Google Antigravity und Claude Aktionen in Gmail ausführen.
Der Gmail-MCP-Server bietet KI-Agenten eine standardisierte Möglichkeit, Folgendes zu tun:
- Daten lesen: E‑Mails durchsuchen, Konversationen abrufen und Labels auflisten.
- Aktionen ausführen: E‑Mail-Entwürfe erstellen und Nachrichten mit Labels versehen.
- Sicherheit berücksichtigen: Die gleichen Berechtigungen und Data-Governance-Einstellungen wie der Nutzer übernehmen.
Vorbereitung
Mitgliedschaft im Google Workspace Entwicklervorschauprogramm.
Ein Google Cloud-Projekt. Informationen zum Erstellen eines Projekts finden Sie unter Projekt erstellen.
Ein MCP-Host, der eine KI-Anwendung wie Google Antigravity oder Claude ist. Die KI-Anwendung erstellt für jeden MCP-Server eine MCP-Clientverbindung.
Richten Sie die gcloud CLI in einer lokalen Entwicklungsumgebung ein, um die Befehle auf dieser Seite auszuführen. Gehen Sie dazu so vor:
- Installieren Sie die Google Cloud CLI.
Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie
gcloud components updateausführen. - Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, melden Sie sich mit Ihrer föderierten Identität in der gcloud CLI an. Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.
- Initialisieren Sie die Google Cloud CLI.
- Installieren Sie die Google Cloud CLI.
Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie
Gmail-MCP-Server konfigurieren
Wenn Sie den Gmail-MCP-Server verwenden möchten, aktivieren Sie ihn in Ihrem Google Cloud-Projekt und konfigurieren Sie Ihre KI-Anwendung so, dass sie eine Verbindung zu ihm herstellt.
APIs aktivieren
Wenn Sie den Gmail-MCP-Server verwenden möchten, aktivieren Sie die folgende API in Ihrem Google Cloud-Projekt:
Gmail API
Befehlszeile
gcloud services enable gmail.googleapis.com --project=PROJECT_ID
Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.
Console
Aktivieren Sie die APIs in der Google Cloud Console:
MCP-Dienste aktivieren
Aktivieren Sie den folgenden Dienst in Ihrem Google Cloud-Projekt, um die MCP-Komponenten für Gmail zu aktivieren:
Gmail MCP API
Befehlszeile
gcloud services enable gmailmcp.googleapis.com --project=PROJECT_ID
Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.
Console
Aktivieren Sie die MCP-Dienste in der Google Cloud Console:
OAuth-Zustimmungsbildschirm einrichten
Der Gmail-MCP-Server verwendet OAuth 2.0 für die Authentifizierung und Autorisierung. Sie müssen den OAuth-Zustimmungsbildschirm konfigurieren, bevor Sie eine OAuth-Client-ID erstellen können.
Rufen Sie in der Google Cloud Console Google Auth Platform > Branding auf.
Wenn Sie die Google Auth Platform bereits konfiguriert haben, können Sie die folgenden Einstellungen für den OAuth-Zustimmungsbildschirm unter Branding, Zielgruppe und Datenzugriff konfigurieren. Wenn Sie die Meldung Google Auth Platform noch nicht konfiguriert sehen, klicken Sie auf Jetzt starten:
- Geben Sie unter App-Informationen im Feld App-Name den Wert
Gmail MCP Serverein. - Wählen Sie unter Nutzersupport-E-Mail Ihre E-Mail-Adresse oder eine entsprechende Google-Gruppe aus.
- Klicken Sie auf Weiter.
- Wählen Sie unter Zielgruppe die Option Intern aus. Wenn Sie Intern nicht auswählen können, wählen Sie Extern aus.
- Klicken Sie auf Weiter.
- Geben Sie unter Kontaktdaten eine E-Mail-Adresse ein, unter der Sie über Änderungen an Ihrem Projekt benachrichtigt werden können.
- Klicken Sie auf Weiter.
- Lesen Sie unter Abschließen die Richtlinie zu Nutzerdaten für Google API-Dienste und wählen Sie Ich akzeptiere die Richtlinie zu Nutzerdaten für Google API-Dienste aus, wenn Sie zustimmen.
- Klicken Sie auf Weiter.
- Klicken Sie auf Erstellen.
- Wenn Sie als Nutzertyp Extern ausgewählt haben, fügen Sie Testnutzer hinzu:
- Klicken Sie auf Zielgruppe.
- Klicken Sie unter Testnutzer auf Nutzer hinzufügen.
- Geben Sie Ihre E-Mail-Adresse und die aller anderen autorisierten Testnutzer ein und klicken Sie auf Speichern.
- Geben Sie unter App-Informationen im Feld App-Name den Wert
Klicken Sie auf Datenzugriff > Bereiche hinzufügen oder entfernen. Es wird ein Bereich mit einer Liste von Bereichen für jede API angezeigt, die Sie in Ihrem Google Cloud-Projekt aktiviert haben.
Fügen Sie unter Bereiche manuell hinzufügen die Bereiche für den Gmail-MCP-Server ein:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.composehttps://www.googleapis.com/auth/gmail.modify
Klicken Sie auf Zur Tabelle hinzufügen.
Klicken Sie auf Aktualisieren.
Nachdem Sie die für Ihre App erforderlichen Bereiche ausgewählt haben, klicken Sie auf der Seite Datenzugriff auf Speichern.
KI-Anwendung konfigurieren
Wenn Sie den Gmail-Remote-MCP-Server zu Ihrer KI-Anwendung hinzufügen möchten, folgen Sie der Anleitung für Ihre Anwendung.
Für vom Nutzer delegierte OAuth 2.0-Client-IDs, die den Gmail-MCP-Server aufrufen, muss unter Google Auth Platform > Clients die Option Diesen Client für einen KI-basierten Agenten verwenden ausgewählt sein. Wenn Sie eine vorhandene OAuth 2.0-Client-ID aktualisieren möchten, wählen Sie diese Einstellung unter Google Auth Platform > Clients aus, wie unter OAuth-Clients verwalten beschrieben. Wenn Sie diese Einstellung für einen vorhandenen Client nicht ändern können oder der Client auch Funktionen unterstützt, die nicht für KI-Agenten bestimmt sind, erstellen Sie eine neue OAuth 2.0-Client-ID für Ihren KI-Agenten. Informationen zu abgelehnten Anfragen, Dienstkonten mit domainweiter Delegierung oder Google Apps Script finden Sie unter Fehlerbehebung.
Antigravity
Wenn Sie den Remote-MCP-Server für Gmail zu Antigravity hinzufügen möchten, fügen Sie die Serverkonfiguration in Ihre mcp_config.json-Datei ein. Diese Anleitung gilt für Antigravity 2.0, Antigravity IDE und Antigravity CLI.
Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Client erstellen auf.
Wählen Sie als Anwendungstyp Webanwendung aus.
Geben Sie einen Namen ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann
https://antigravity.google/oauth-callbackin das Feld URIs ein.Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus.
Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihren Clientschlüssel.
Öffnen oder erstellen Sie die Konfigurationsdatei
~/.gemini/config/mcp_config.json.Fügen Sie die
mcpServers-Konfiguration zumcp_config.jsonhinzu:{ "mcpServers": { "gmail": { "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }Ersetzen Sie Folgendes:
OAUTH_CLIENT_ID: Die von Ihnen erstellte Client-ID.OAUTH_CLIENT_SECRET: Der von Ihnen erstellte Clientschlüssel.
mcp_config.jsonsparen.Authentifizieren Sie den MCP-Server. Sie können sich entweder über die GUI-Einstellungen oder die Befehlszeile authentifizieren:
Für Antigravity IDE oder GUI (Antigravity 2.0):
- Öffnen Sie den Bildschirm „Einstellungen“ (z.B. durch Klicken auf Einstellungen unten links oder durch Öffnen von Antigravity-Nutzereinstellungen).
- Gehen Sie zu Anpassungen.
- Klicken Sie unter Installierte MCP-Server auf Aktualisieren.
- Suchen Sie in der Liste nach
gmail, klicken Sie auf Authentifizieren, melden Sie sich in Ihrem Google-Konto an, kopieren Sie den Autorisierungscode, fügen Sie ihn in das Eingabefeld ein und klicken Sie auf Senden.
Für die Antigravity CLI:
Starten Sie die Antigravity CLI:
agyÖffnen Sie das interaktive MCP-Verwaltungsfeld mit folgendem Befehl:
/mcpWählen Sie mit den Pfeiltasten
gmailaus, gehen Sie zur Aktion Authentifizieren und drücken Sie die Eingabetaste. Schließen Sie die Anmeldung in Ihrem Browser ab, kopieren Sie den Autorisierungscode, fügen Sie ihn in die Terminal-Eingabeaufforderung ein und drücken Sie die Eingabetaste.
Prüfen Sie, ob der Server richtig konfiguriert ist und ausgeführt wird:
- Für die Antigravity-IDE oder ‑GUI: Neben dem Server wird unter Anpassungen > Installierte MCP-Server der Button Abmelden angezeigt.
- Für die Antigravity CLI: Öffnen Sie den Bereich
/mcp, um Ihre konfigurierten MCP-Server anzusehen. Bei verifizierten und authentifizierten Servern wird im interaktiven TUI-Bereich neben dem Namen Authed angezeigt. Sie können einen beliebigen Server in der Dashboard-Ansicht auswählen, um seinen Status zu prüfen und alle verfügbaren Tools aufzulisten.
Der Remote-MCP-Server ist jetzt in Antigravity einsatzbereit.
Claude
Wenn Sie den Gmail-Remote-MCP-Server mit Claude.ai oder Claude Desktop verwenden möchten, benötigen Sie ein Claude Enterprise-, Pro-, Max- oder Team-Abo.
Wenn Sie den Gmail-Remote-MCP-Server zu Claude hinzufügen möchten, konfigurieren Sie einen benutzerdefinierten Connector mit einer OAuth-Client-ID und einem Clientschlüssel.
Erstellen Sie eine OAuth 2.0-Client-ID und ein Secret:
Rufen Sie in der Google Cloud Console Google Auth Platform > Clients > Client erstellen auf.
Wählen Sie als Anwendungstyp Webanwendung aus.
Geben Sie einen Namen ein.
Klicken Sie im Abschnitt Autorisierte Weiterleitungs-URIs auf + URI hinzufügen und fügen Sie dann
https://claude.ai/api/mcp/auth_callbackin das Feld URIs ein.Wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus.
Klicken Sie auf Erstellen und kopieren Sie Ihre Client-ID und Ihren Clientschlüssel.
Konfigurieren Sie den MCP-Server in Claude:
- Gehen Sie in Claude.ai oder Claude für Desktop zu den Einstellungen > Connectors oder zu den Administratoreinstellungen > Connectors.
- Klicken Sie auf Benutzerdefinierten Connector hinzufügen.
- Geben Sie die Verbindungsdetails für Gmail ein:
- Server name:
Gmail. - Remote-MCP-Server-URL:
https://gmailmcp.googleapis.com/mcp/v1
- Server name:
- Geben Sie unter Erweiterte Einstellungen Ihre OAuth-Client-ID und Ihren OAuth-Clientschlüssel ein.
- Klicken Sie auf Hinzufügen.
Sonstiges
Viele KI-Anwendungen bieten Möglichkeiten, eine Verbindung zu einem Remote-MCP-Server herzustellen. In der Regel müssen Sie Details zum Server eingeben, z. B. den Namen, die Endpunkte, das Transportprotokoll und die Authentifizierungsmethode. Geben Sie für den Remote-MCP-Server für Gmail Folgendes ein:
Server name:
gmailServer-URL:
https://gmailmcp.googleapis.com/mcp/v1Transport: Streamable HTTP
Authentifizierung: Der Gmail-Remote-MCP-Server verwendet OAuth 2.0. Wählen Sie beim Erstellen des OAuth 2.0-Clients Diesen Client für einen KI-basierten Agenten verwenden aus. Weitere Informationen finden Sie unter Informationen zu Authentifizierung und Autorisierung.
Wenn Sie stündliche Aufforderungen zur Anmeldung mit einem OAuth-Client für Webanwendungen vermeiden möchten, konfigurieren Sie Ihren MCP-Client so, dass er Offlinezugriff mit
access_type=offlineoder dem Bereichoffline_accessanfordert. Weitere Informationen finden Sie unter Stündliche Aufforderungen zur Anmeldung.
Weitere Informationen zum Verbinden verschiedener Arten von KI-Anwendungen finden Sie unter MCP in einer KI-Anwendung konfigurieren.
Gmail-MCP-Server testen
Nachdem Sie Ihre KI-Anwendung konfiguriert haben, können Sie die Verbindung prüfen, indem Sie einige Test-Prompts ausführen.
Stellen Sie Ihrer KI-Anwendung die folgenden Fragen:
„Was hat Ariel in ihrer letzten E‑Mail zu unserem Marketingplan gesagt?“
Der Client filtert mit
gmail.search_threadsnach E‑Mails von Ariel, ruft mitgmail.get_threadden Inhalt des neuesten Threads ab und fasst ihn dann für Sie zusammen.„Entwirf eine E‑Mail an ariel@beispiel.de, in der du sagst, dass ich den Marketingplan genehmige.“
Der Client verwendet
gmail.create_draft, um eine E‑Mail in Ihrem Ordner „Entwürfe“ zu erstellen. Sie können sie dann in Gmail prüfen und senden.
Wenn die Tools erfolgreich ausgeführt werden und Sie relevante Antworten erhalten, ist Ihr Gmail-MCP-Server richtig konfiguriert.
Fehlerbehebung
In den folgenden Abschnitten erfahren Sie, wie Sie häufige Authentifizierungs- und Verbindungsprobleme mit dem Gmail-MCP-Server beheben.
OAuth-Protokollereignisse prüfen
Wenn Sie Probleme beim Herstellen einer Verbindung zum MCP-Server haben, prüfen Sie die OAuth-Logs auf Fehler. Bitten Sie Ihren Google Workspace-Administrator, die OAuth-Protokollereignisse im Sicherheitsprüftool zu prüfen.
Abgelehnte Anfragen von nutzerdelegierten OAuth-Clients
Wenn Ihre Anfragen an den MCP-Server abgelehnt werden, prüfen Sie, ob für die vom Nutzer delegierte OAuth 2.0-Client-ID für Ihren dreibeinigen OAuth-Flow in der Google Auth Platform > Clients die Option Diesen Client für einen KI-basierten Agenten verwenden ausgewählt ist:
- Der vorhandene Client unterstützt die Einstellung: Wählen Sie für Ihren vorhandenen OAuth-Client Diesen Client für einen KI-basierten Agenten verwenden aus.
- Vorhandener Client kann nicht aktualisiert werden: Erstellen Sie einen neuen OAuth-Client, wählen Sie Diesen Client für einen KI-basierten Agenten verwenden aus und aktualisieren Sie Ihre Anwendung, um ihn zu verwenden.
- Der vorhandene Client unterstützt auch Funktionen, die nicht auf KI-Agenten basieren: Erstellen Sie einen separaten OAuth-Client für den KI-Agenten und behalten Sie den vorhandenen Client für Ihre Funktionen, die nicht auf KI-Agenten basieren.
Eine Anleitung finden Sie unter KI-Anwendung konfigurieren und OAuth-Clients verwalten.
Dienstkonten mit domainweiter Delegierung
Wenn Ihre App ein Dienstkonto mit domainweiter Delegierung für 2-Legged OAuth verwendet, können Sie Diesen Client für einen KI-basierten Agenten verwenden nicht auswählen, da Dienstkonten nicht in der Google Auth Platform > Clients verwaltet werden:
- Zugriffssteuerung: Anfragen an den MCP-Server von diesen Dienstkonten werden nicht abgelehnt, weil die Agent-Einstellung fehlt. Stattdessen wird der Zugriff durch die Einstellungen für die domainweite Delegierung geregelt, die Ihr Google Workspace-Administrator verwaltet. Weitere Informationen zu Administratoreinstellungen finden Sie unter API-Zugriff mit domainweiter Delegierung steuern.
- Sensible Aktionen: Google Workspace-MCP-Server geben weiterhin Aufforderungen zur Formularerfassung für die Bestätigung durch einen Human in the Loop bei sensiblen Toolaufrufen zurück, die über die Identitätsübernahme von Nutzern mit domainweiter Delegation erfolgen.
Anfragen von Apps Script
Wenn Sie den MCP-Server über Apps Script aufrufen, können Sie für den Standard-OAuth-Client, den Apps Script für Ihr Script erstellt und verwaltet, nicht die Option Diesen Client für einen KI-basierten Agenten verwenden auswählen. Dies gilt auch, wenn Ihr Script ein Google Cloud-Standardprojekt verwendet.
So rufen Sie den MCP-Server über Apps Script auf:
- Rufen Sie in der Google Cloud Console Google Auth Platform > Clients auf, erstellen Sie einen OAuth-Client und wählen Sie Diesen Client für einen KI-gestützten Agenten verwenden aus.
- Verwenden Sie in Ihrem Script die OAuth2 for Apps Script-Bibliothek, um Nutzer mit diesem OAuth-Client zu autorisieren.
- Wenn Sie den MCP-Server aufrufen, senden Sie das von der Bibliothek zurückgegebene Zugriffstoken anstelle des Tokens von
ScriptApp.getOAuthToken.
Apps Script-Projekte, die keine Google Workspace-MCP-Server aufrufen, sind nicht betroffen.
Wiederholte stündliche Aufforderungen zur Anmeldung
Wenn Sie etwa jede Stunde aufgefordert werden, sich noch einmal anzumelden, empfängt oder verwendet Ihr MCP-Client kein Aktualisierungstoken. Dies geschieht in der Regel in den folgenden Situationen:
- Fehlender Offlinezugriff auf einen OAuth-Client für Webanwendungen: Im Gegensatz zu OAuth-Clients für Desktop-Anwendungen ist bei OAuth-Clients für Webanwendungen standardmäßig der Onlinezugriff aktiviert. Wenn Sie ein Aktualisierungstoken anfordern möchten, fügen Sie
access_type=offlineoder den OpenID Connect-Bereich (OIDC)offline_accesszusammen mit mindestens einem API-Bereich ein und legen Sieaccess_type=onlinenicht fest. - Erneute Autorisierung einer App, für die bereits eine Einwilligung erteilt wurde: Der OAuth 2.0-Server von Google stellt ein Aktualisierungstoken aus, wenn ein Nutzer zum ersten Mal Offlinezugriff gewährt. Wenn ein Nutzer Ihren OAuth-Client bereits ohne Offlinezugriff autorisiert hat oder wenn Ihr MCP-Client sein gespeichertes Aktualisierungstoken verloren hat, wird bei nachfolgenden Anmeldungen möglicherweise kein neues Aktualisierungstoken zurückgegeben. Fügen Sie
prompt=consentin die Autorisierungsanfrage ein oder entfernen Sie den Zugriff der App in den Google-Kontoverbindungen und melden Sie sich noch einmal an. - Statisches Inhabertoken: Wenn Sie ein Rohzugriffstoken in einem
Authorization-Header übergeben, z. B. die Ausgabe vongcloud auth print-access-token, läuft das Token nach einer Stunde ab, sofern es nicht von Ihrem Client aktualisiert wird.
Weitere Informationen finden Sie unter Zugriffstoken aktualisieren.
Toolreferenz
Die folgenden Tools sind für den Gmail-MCP-Server verfügbar. Informationen zu Eingabe- und Ausgabeschemas finden Sie in der Gmail-MCP-Referenz:
create_draftget_messageget_threadlabel_messagelabel_threadlist_draftslist_labelssearch_threadsunlabel_messageunlabel_thread
Wichtiger Sicherheitsaspekt: Indirekte Prompt Injection
Wenn Sie ein Language Model nicht vertrauenswürdigen Daten aussetzen, besteht das Risiko eines indirekten Prompt-Injection-Angriffs. Da KI-Anwendungen wie Google Antigravity über den Gmail-MCP-Server Zugriff auf leistungsstarke Tools und APIs haben, können sie Daten in Ihrem Google-Konto lesen, ändern und löschen.
Um diese Risiken zu minimieren, müssen Sie Prompts und Antworten auf schädliche Inhalte oder Prompt-Injection-Angriffe prüfen. Sie können das von Google bereitgestellte Model Armor verwenden oder eine eigene Lösung, wenn Sie sie dokumentieren, damit Nutzer das Risiko akzeptieren können. Eine Anleitung finden Sie im Hilfeartikel Sicherheit für Google Workspace-MCP-Server konfigurieren.
Wir empfehlen folgende Best Practices:
- Verwenden Sie nur vertrauenswürdige Tools. Verbinden Sie den Gmail-MCP-Server niemals mit nicht vertrauenswürdigen oder nicht verifizierten Anwendungen.
- Seien Sie vorsichtig bei nicht vertrauenswürdigen Eingaben. Vermeiden Sie es, Ihre KI-Anwendung aufzufordern, E-Mails oder andere Ressourcen aus nicht verifizierten Quellen zu verarbeiten. Diese Eingaben können versteckte Anweisungen enthalten, die Ihre Sitzung kapern und es einem Angreifer ermöglichen, Ihre Daten zu ändern, zu stehlen oder zu löschen.
- Überprüfen Sie alle Aktionen. Prüfen Sie immer sorgfältig die von Ihrer KI-Anwendung in Ihrem Namen ausgeführten Aktionen, um sicherzustellen, dass sie korrekt sind und Ihren Absichten entsprechen.