Gmail MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Gmail-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

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