Gmail über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Gmail klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Gmail + Gemini

Lass deine KI in Gmail arbeiten: das Postfach mit Gmails eigener Suchsyntax durchsuchen, Nachrichten und Konversationen lesen, Mails als gelesen markieren, archivieren, mit Stern oder Label versehen und Mails schreiben, beantworten und senden oder als Entwurf speichern, den du vorher prüfst. Privates Gmail und Google Workspace, mit deinem eigenen Google-OAuth-Client.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Schritt 1 — Zugangsdaten holen

1. Öffne console.cloud.google.com, wähle ein Projekt aus oder lege eines an, gehe zu APIs & Services → Library und aktiviere die Gmail API.
2. Öffne APIs & Services → OAuth consent screen. Wähle Internal, wenn das Postfach in Google Workspace liegt (der einfachste Weg), sonst External. Bei External setzt du den Veröffentlichungsstatus auf In production: Solange die App im Status Testing ist, widerruft Google ihre Refresh-Tokens nach 7 Tagen und der Connector hört jede Woche auf zu funktionieren.
3. Öffne APIs & Services → Credentials → Create credentials → OAuth client ID, wähle den Anwendungstyp Web application und füge die autorisierte Weiterleitungs-URI https://cloud.anythingmcp.com/api/mcp-oauth/callback hinzu. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein.
4. Trage die Client-ID in GOOGLE_CLIENT_ID und das Client-Secret in GOOGLE_CLIENT_SECRET ein, dann installiere den Connector.
5. Klicke auf der Connector-Seite auf Authorize with Provider und melde dich mit dem Gmail-Konto an, mit dem die KI arbeiten soll. Der Refresh-Token wird verschlüsselt gespeichert, Access-Tokens werden automatisch erneuert.
6. Lass die KI gmail_get_profile aufrufen: Das Tool zeigt die Adresse, mit der der Connector arbeitet, und wie viele Nachrichten und Konversationen das Postfach enthält.

Ein Google-Client für alle Google-Connectors: Dasselbe Cloud-Projekt und derselbe OAuth-Client bedienen alle Google-Connectors: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Tasks, Search Console, Analytics und Ads. Aktiviere jede API in diesem Projekt, verwende dieselbe Client-ID und dasselbe Secret und autorisiere jeden Connector einmal. Jeder Connector fragt nur nach seinen eigenen Berechtigungen.

Google-Verifizierung: Google stuft die Gmail-Berechtigungen dieses Connectors (gmail.modify und für ein Nur-lesen-Setup gmail.readonly) als eingeschränkt (restricted) ein. Eine Internal-App, die nur Konten der Workspace-Organisation nutzen, der das Cloud-Projekt gehört, braucht keine Verifizierung: Für ein Unternehmen ist das der direkte Weg. Eine External-App, die andere Menschen nutzen, zeigt die Warnung „Google hasn't verified this app“ und ist auf 100 Nutzer begrenzt, bis sie Googles Verifizierung bestanden hat, die bei eingeschränkten Berechtigungen eine Sicherheitsprüfung einschließt. Für ein einzelnes privates Gmail-Konto funktioniert eine External-App In production, die nur du nutzt, wenn du die Warnung überspringst.

Berechtigungen: Der Connector fragt nach https://www.googleapis.com/auth/gmail.modify: Mails lesen, Labels ändern (als gelesen markieren, archivieren, Stern setzen), Entwürfe anlegen und Mails senden. Er arbeitet als das Google-Konto, das ihn autorisiert hat, und sieht genau das, was dieses Konto sieht. Endgültig löschen kann er nichts.

Was echte Mails verschickt: gmail_send_message (eine neue Mail), gmail_reply (eine Antwort in einer Konversation) und gmail_send_draft (ein vorhandener Entwurf, genau so, wie er geschrieben ist) senden sofort von der angemeldeten Adresse, und das lässt sich nicht rückgängig machen. gmail_create_draft speichert nur einen Entwurf, auch als Antwort in einer Konversation, den du in Gmail prüfst und abschickst; der Connector weist die KI an, einen Entwurf vorzuziehen, wenn du nicht klar ums Senden gebeten hast. Eine Nachricht erreicht höchstens 500 Empfänger. Eine Mail, die die KI liest, könnte Text enthalten, der sie auffordert, etwas zu senden: Soll die KI Mails nur vorbereiten, deaktiviere gmail_send_message, gmail_reply und gmail_send_draft und schicke die Entwürfe selbst ab.

Nur lesen: Ändere den Scope in den OAuth-Einstellungen des Connectors auf https://www.googleapis.com/auth/gmail.readonly, autorisiere erneut und deaktiviere gmail_modify_message_labels, gmail_modify_thread_labels, gmail_create_draft, gmail_send_draft, gmail_send_message und gmail_reply.

Mails lesen und sortieren: Die Suche nutzt dieselbe Syntax wie das Gmail-Suchfeld, zum Beispiel from:[email protected] is:unread newer_than:7d oder has:attachment. Nachrichten und Konversationen kommen als reiner Text zurück (reine HTML-Mails werden umgewandelt); ein sehr langer Text wird nach 20.000 Zeichen abgeschnitten, bei einer ganzen Konversation nach 100.000. Anhänge werden mit Name, Typ und Größe aufgelistet, aber nicht heruntergeladen. Als gelesen markieren, archivieren, mit Stern versehen und unter einem Label ablegen sind Label-Änderungen an einer Nachricht oder einer ganzen Konversation.

Rate Limits: Gmail erlaubt 6.000 Kontingenteinheiten pro Minute und Nutzer. Eine Suche kostet 5, eine Nachricht lesen 20, eine Konversation 40 und eine Nachricht oder einen Entwurf senden 100. Über dem Limit antwortet Gmail mit 429 (oder 403 userRateLimitExceeded): Warte eine Minute und versuche es erneut.

Häufige Fehler: 401 heißt, dass die Autorisierung abgelaufen ist oder widerrufen wurde (immer nach 7 Tagen, solange der Zustimmungsbildschirm auf Testing steht): Klicke erneut auf Authorize with Provider. 403 accessNotConfigured heißt, dass die Gmail API im Cloud-Projekt nicht aktiviert ist. 403 insufficientPermissions oder ACCESS_TOKEN_SCOPE_INSUFFICIENT heißt, dass der Scope den Aufruf nicht erlaubt, etwa eine Label-Änderung bei einem Nur-lesen-Setup. 404 heißt, dass es die ID in diesem Postfach nicht gibt; eine Entwurfs-ID (sie beginnt mit r-) ist keine Nachrichten-ID. 400 invalidArgument heißt meist, dass es eine Label-ID nicht gibt: Eigene Labels haben IDs wie Label_12, die gmail_list_labels liefert.

Der Connector sendet keine Anhänge und lädt keine herunter, leitet keine Mails mit ihren Originalanhängen weiter, verschiebt nichts in den Papierkorb, löscht nichts und unterstützt keine Filter, Einstellungen, Absender-Aliasse oder Postfächer anderer Personen.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Gmail-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche ungelesenen Mails der letzten 3 Tage brauchen noch eine Antwort von mir? Fass jede in einem Satz zusammen.“
• „Such die letzte Mail von [email protected] zum Angebot und schreib einen Antwortentwurf, der den neuen Termin bestätigt. Nicht senden, ich prüfe ihn in Gmail.“
• „Archiviere alle Newsletter in meinem Posteingang, die älter als eine Woche sind, markiere sie als gelesen und liste auf, was du archiviert hast.“
• „Liste alle Mails mit Anhang seit dem 1. Oktober auf, die nach Rechnungen aussehen, mit Absender, Datum, Betreff und Dateiname.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Meta Muse verbinden