Gmail MCP-Server

Ein leistungsstarker Model Context Protocol (MCP)-Server, der Claude AI die direkte Interaktion mit Gmail ermöglicht.

📖 Inhaltsverzeichnis

• Überblick

• Hauptmerkmale

• Schnellstart

  • Voraussetzungen

  • Installation

  • Einrichten von Google Cloud- und OAuth-Anmeldeinformationen

  • Erster Lauf und Authentifizierung

  • Claude Desktop konfigurieren

• Verfügbare Tools

• Anwendungsbeispiele

• Erweiterte Konfiguration

  • Umgebungsvariablen

  • SSE-Servermodus

• Dokumentation

• Sicherheitsüberlegungen

• Beitragen

• Lizenz

• Danksagung

📋 Übersicht

Der Gmail MCP Server ist eine umfassende Implementierung, die es KI-Assistenten wie Claude ermöglicht, direkt über natürliche Sprache mit Gmail zu interagieren. Er bietet umfangreiche Tools für das E-Mail-Management und ermöglicht eine nahtlose Integration zwischen Konversations-KI und Ihrem Posteingang.

💡 Hauptfunktionen

• Umfassende E-Mail-Verwaltung

  • Senden Sie reine Text- und HTML-E-Mails mit Anhängen

  • Lesen Sie E-Mails mit der richtigen Analyse komplexer Nachrichtenstrukturen

  • Durchsuchen Sie Ihren Posteingang mit der leistungsstarken Abfragesyntax von Gmail

  • Erstellen und Aktualisieren von E-Mail-Entwürfen

  • Verwalten Sie Beschriftungen, den Status „Gelesen/Ungelesen“ und den Papierkorb

  • Führen Sie Stapelverarbeitungen für mehrere E-Mails durch

• Erweiterte Integration

  • Moderne Python-Codebasis mit Async/Await-Muster

  • Umfassende Fehlerbehandlung und -behebung

  • Detaillierte Fortschrittsberichte

  • Sicherer OAuth-Authentifizierungsablauf

  • Mehrere Transportmodi (STDIO und SSE)

  • Unterstützung für verschiedene Bereitstellungsszenarien

🚀 Schnellstart

Voraussetzungen

• Python 3.8 oder höher

• Ein Google Cloud-Projekt mit aktivierter Gmail-API

• OAuth 2.0-Anmeldeinformationen für die Gmail-API

Installation

1. Klonen Sie das Repository

   git clone https://github.com/yourusername/gmail-mcp-server.git cd gmail-mcp-server

2. Einrichten einer virtuellen Umgebung

   python -m venv venv # On Windows venv\Scripts\activate # On macOS/Linux source venv/bin/activate

3. Installieren von Abhängigkeiten

   pip install -r requirements.txt

4. Einrichten von Google Cloud- und OAuth-Anmeldeinformationen

   Besuchen Sie die Google Cloud Console , um:

   • Erstellen eines neuen Projekts

   • Aktivieren Sie die Gmail-API

   • OAuth-Zustimmungsbildschirm einrichten

   • OAuth-Client-ID-Anmeldeinformationen erstellen (Desktopanwendung)

   • Laden Sie die Anmeldeinformationen als credentials.json im Projektstammverzeichnis herunter

Erster Lauf und Authentifizierung

Führen Sie den Server einmal aus, um sich zu authentifizieren:

Es öffnet sich ein Browserfenster, in dem Sie aufgefordert werden, sich mit Ihrem Google-Konto zu authentifizieren. Nach der Authentifizierung wird eine token.json Datei erstellt und für die zukünftige Verwendung gespeichert.

Claude Desktop konfigurieren

1. Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie den Gmail MCP-Server zur Konfiguration hinzu:

   { "mcpServers": { "gmail": { "command": "python", "args": [ "/absolute/path/to/gmail-mcp-server/gmail_server.py" ] } } }

3. Speichern Sie die Datei und starten Sie Claude Desktop neu

Hinweis: Ersetzen Sie "/absolute/path/to/gmail-mcp-server/gmail_server.py" durch den tatsächlichen absoluten Pfad zur Datei gmail_server.py in Ihrem geklonten Repository.

🧰 Verfügbare Tools

Der Gmail MCP-Server stellt Claude die folgenden Tools zur Verfügung:

E-Mail-Versand

• send_email - Senden Sie einfache E-Mails mit Text-/HTML-Inhalt

• send_email_with_attachment - E-Mails mit Dateianhängen senden

• send_email_with_multiple_attachments – Senden Sie E-Mails mit mehreren Anhängen

E-Mail lesen

• read_email - Liest den Inhalt einer bestimmten E-Mail nach ID

• get_unread_emails - Eine Liste ungelesener E-Mails abrufen

• get_important_emails – Erhalten Sie als wichtig markierte E-Mails

• get_emails_with_attachments - E-Mails mit Anhängen abrufen

• get_recent_emails - E-Mails der letzten X Tage abrufen

E-Mail-Suche und -Organisation

• search_emails – E-Mails mit der Abfragesyntax von Gmail durchsuchen

• get_email_labels – Listet alle Gmail-Labels/Ordner auf

• create_email_label – Erstelle ein neues Label

• delete_email_label – Löscht ein vorhandenes Label

• label_email – Wenden Sie ein Label auf eine E-Mail an

• remove_email_label – Entfernt ein Label aus einer E-Mail

E-Mail-Statusverwaltung

• mark_as_read – Markieren Sie eine E-Mail als gelesen

• mark_as_unread – Markieren Sie eine E-Mail als ungelesen

• delete_email - Eine E-Mail in den Papierkorb verschieben

Entwurfsverwaltung

• create_email_draft – Einen neuen E-Mail-Entwurf erstellen

• update_email_draft – Einen vorhandenen Entwurf aktualisieren

• list_email_drafts – Liste verfügbarer Entwürfe

• send_draft - Einen vorhandenen Entwurf senden

Batch-Operationen

• batch_apply_label - Wenden Sie ein Label auf mehrere E-Mails an

• batch_delete_emails - Mehrere E-Mails in den Papierkorb verschieben

Kontoinformationen

• get_email_profile – Gmail-Profilinformationen abrufen

• summarize_recent_emails - Erstellen Sie eine Zusammenfassung der letzten E-Mails

💬 Anwendungsbeispiele

Hier sind einige Beispielaufforderungen für Claude:

🔧 Erweiterte Konfiguration

Umgebungsvariablen

Der Server unterstützt mehrere Umgebungsvariablen zur Anpassung:

SSE-Servermodus

Der Server kann im SSE-Modus (Server-Sent Events) für die HTTP-basierte Integration ausgeführt werden:

Dadurch wird der Server auf dem angegebenen Port (Standard: 3000) gestartet und ist über HTTP erreichbar.

📚 Dokumentation

• MCP-Spezifikation – Erfahren Sie mehr über das Model Context Protocol

• Gmail-API-Dokumentation – Referenz für Gmail-API-Funktionen

• Google Cloud OAuth – Details zu Authentifizierungsabläufen

🔒 Sicherheitsüberlegungen

• Der Server verwendet OAuth 2.0 für die sichere Gmail-API-Authentifizierung

• Alle Aktionen werden lokal auf Ihrem Computer ausgeführt – E-Mails werden niemals über Server von Drittanbietern geleitet

• Authentifizierungstoken werden lokal gespeichert und können jederzeit widerrufen werden

• Der Server benötigt lokalen Dateizugriff nur zum Lesen von Anhängen

• Claude bittet immer um Bestätigung, bevor er E-Mails sendet oder löscht

🤝 Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )

3. Übernehmen Sie Ihre Änderungen ( git commit -m 'Add some amazing feature' )

4. Pushen zum Zweig ( git push origin feature/amazing-feature )

5. Öffnen einer Pull-Anfrage

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

🙏 Danksagungen

• Google für die Gmail-API

• Anthropisch für Claude und das Modellkontextprotokoll

• Mitwirkende an den Python Gmail API-Clientbibliotheken