Gmail über MCP mit Cursor 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 + Cursor

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent 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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

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