Gmail AutoAuth MCP-Server

Ein Model Context Protocol (MCP)-Server für die Gmail-Integration in Claude Desktop mit automatischer Authentifizierungsunterstützung. Dieser Server ermöglicht KI-Assistenten die Verwaltung von Gmail durch natürliche Sprachinteraktionen.

Merkmale

• Senden Sie E-Mails mit Betreff, Inhalt, Anhängen und Empfängern

• Vollständige Unterstützung für internationale Zeichen in Betreffzeilen und E-Mail-Inhalten

• Lesen Sie E-Mail-Nachrichten anhand der ID mit erweiterter MIME-Strukturverarbeitung

• Informationen zu E-Mail-Anhängen anzeigen (Dateinamen, Typen, Größen)

• E-Mails anhand verschiedener Kriterien (Betreff, Absender, Datumsbereich) durchsuchen

• Umfassende Etikettenverwaltung mit der Möglichkeit, Etiketten zu erstellen, zu aktualisieren, zu löschen und aufzulisten

• Alle verfügbaren Gmail-Labels auflisten (systemdefiniert und benutzerdefiniert)

• Listen Sie E-Mails im Posteingang, in gesendeten oder benutzerdefinierten Labels auf

• E-Mails als gelesen/ungelesen markieren

• E-Mails in andere Labels/Ordner verschieben

• E-Mails löschen

• Stapelverarbeitung zur effizienten Verarbeitung mehrerer E-Mails gleichzeitig

• Vollständige Integration mit der Gmail-API

• Einfacher OAuth2-Authentifizierungsablauf mit automatischem Browserstart

• Unterstützung für Anmeldeinformationen sowohl für Desktop- als auch für Webanwendungen

• Globale Speicherung von Anmeldeinformationen für mehr Komfort

Installation und Authentifizierung

Installation über Smithery

So installieren Sie Gmail AutoAuth für Claude Desktop automatisch über Smithery :

Manuelle Installation

1. Erstellen Sie ein Google Cloud-Projekt und rufen Sie die Anmeldeinformationen ab:

   a. Erstellen Sie ein Google Cloud-Projekt:

   • Gehen Sie zur Google Cloud Console

   • Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus

   • Aktivieren Sie die Gmail-API für Ihr Projekt

   b. OAuth 2.0-Anmeldeinformationen erstellen:

   • Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“

   • Klicken Sie auf „Anmeldeinformationen erstellen“ > „OAuth-Client-ID“.

   • Wählen Sie als Anwendungstyp entweder „Desktop-App“ oder „Webanwendung“

   • Geben Sie ihm einen Namen und klicken Sie auf „Erstellen“.

   • Für Webanwendungen fügen Sie http://localhost:3000/oauth2callback zu den autorisierten Umleitungs-URIs hinzu.

   • Laden Sie die JSON-Datei mit den OAuth-Schlüsseln Ihres Clients herunter

   • Benennen Sie die Schlüsseldatei in gcp-oauth.keys.json um

2. Authentifizierung ausführen:

   Sie können sich auf zwei Arten authentifizieren:

   a. Globale Authentifizierung (empfohlen):

   # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder mkdir -p ~/.gmail-mcp mv gcp-oauth.keys.json ~/.gmail-mcp/ # Run authentication from anywhere npx @gongrzhe/server-gmail-autoauth-mcp auth

   b. Lokale Authentifizierung:

   # Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @gongrzhe/server-gmail-autoauth-mcp auth

   Der Authentifizierungsprozess wird:

   • Suchen Sie nach gcp-oauth.keys.json im aktuellen Verzeichnis oder ~/.gmail-mcp/

   • Wenn es im aktuellen Verzeichnis gefunden wird, kopieren Sie es nach ~/.gmail-mcp/

   • Öffnen Sie Ihren Standardbrowser für die Google-Authentifizierung

   • Anmeldeinformationen speichern als ~/.gmail-mcp/credentials.json

   Notiz :

   • Nach erfolgreicher Authentifizierung werden die Anmeldeinformationen global in ~/.gmail-mcp/ gespeichert und können von jedem Verzeichnis aus verwendet werden

   • Die Anmeldeinformationen für Desktop-Apps und Webanwendungen werden unterstützt.

   • Stellen Sie für die Anmeldeinformationen von Webanwendungen sicher, dass Sie http://localhost:3000/oauth2callback zu Ihren autorisierten Umleitungs-URIs hinzufügen.

3. In Claude Desktop konfigurieren:

Docker-Unterstützung

Wenn Sie Docker bevorzugen:

1. Authentifizierung:

2. Verwendung:

Cloud-Server-Authentifizierung

Für Cloud-Serverumgebungen (wie n8n) können Sie während der Authentifizierung eine benutzerdefinierte Rückruf-URL angeben:

Einrichtungsanweisungen für die Cloud-Umgebung

1. Reverse-Proxy konfigurieren:

   • Richten Sie Ihren n8n-Container so ein, dass ein Port für die Authentifizierung verfügbar ist

   • Konfigurieren Sie einen Reverse-Proxy, um den Verkehr von Ihrer Domäne (z. B. gmail.gongrzhe.com ) an diesen Port weiterzuleiten

2. DNS-Konfiguration:

   • Fügen Sie in Ihren DNS-Einstellungen einen A-Eintrag hinzu, um Ihre Domain in die IP-Adresse Ihres Cloud-Servers aufzulösen

3. Einrichtung der Google Cloud Platform:

   • Fügen Sie in Ihrer Google Cloud Console Ihre benutzerdefinierte Domänen-Callback-URL (z. B. https://gmail.gongrzhe.com/oauth2callback ) zur Liste der autorisierten Umleitungs-URIs hinzu

4. Authentifizierung ausführen:

   npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback

5. Konfigurieren Sie in Ihrer Anwendung:

   { "mcpServers": { "gmail": { "command": "npx", "args": [ "@gongrzhe/server-gmail-autoauth-mcp" ] } } }

Dieser Ansatz ermöglicht ordnungsgemäß funktionierende Authentifizierungsabläufe in Umgebungen, in denen der lokale Host nicht zugänglich ist, wie etwa bei containerisierten Anwendungen oder Cloud-Servern.

Verfügbare Tools

Der Server bietet die folgenden Tools, die über Claude Desktop verwendet werden können:

1. E-Mail senden ( send_email )

Sendet sofort eine neue E-Mail.

2. E-Mail-Entwurf ( draft_email )

Erstellt einen E-Mail-Entwurf, ohne ihn zu senden.

3. E-Mail lesen ( read_email )

Ruft den Inhalt einer bestimmten E-Mail anhand ihrer ID ab.

4. E-Mails suchen ( search_emails )

Sucht nach E-Mails mit der Gmail-Suchsyntax.

5. E-Mail ändern ( modify_email )

Fügt Beschriftungen zu E-Mails hinzu oder entfernt sie (in andere Ordner verschieben, archivieren usw.).

6. E-Mail löschen ( delete_email )

Löscht eine E-Mail dauerhaft.

7. E-Mail-Labels auflisten ( list_email_labels )

Ruft alle verfügbaren Gmail-Labels ab.

8. Label erstellen ( create_label )

Erstellt ein neues Gmail-Label.

9. Label aktualisieren ( update_label )

Aktualisiert ein vorhandenes Gmail-Label.

10. Label löschen ( delete_label )

Löscht ein Gmail-Label.

11. Label abrufen oder erstellen ( get_or_create_label )

Ruft ein vorhandenes Label nach Namen ab oder erstellt es, wenn es nicht vorhanden ist.

12. E-Mails stapelweise ändern ( batch_modify_emails )

Ändert Beschriftungen für mehrere E-Mails in effizienten Stapeln.

13. E-Mails stapelweise löschen ( batch_delete_emails )

Löscht mehrere E-Mails dauerhaft in effizienten Stapeln.

Erweiterte Suchsyntax

Das Tool search_emails unterstützt die leistungsstarken Suchoperatoren von Gmail:

Sie können mehrere Operatoren kombinieren: from:john@example.com after:2024/01/01 has:attachment

Erweiterte Funktionen

Extraktion von E-Mail-Inhalten

Der Server extrahiert E-Mail-Inhalte auf intelligente Weise aus komplexen MIME-Strukturen:

• Priorisiert Klartextinhalte, sofern verfügbar

• Fällt auf HTML-Inhalte zurück, wenn kein einfacher Text verfügbar ist

• Verarbeitet mehrteilige MIME-Nachrichten mit verschachtelten Teilen

• Verarbeitet Informationen zu Anhängen (Dateiname, Typ, Größe)

• Behält die ursprünglichen E-Mail-Header bei (Von, An, Betreff, Datum)

Internationaler Charakter-Support

Der Server unterstützt vollständig Nicht-ASCII-Zeichen in E-Mail-Betreffzeilen und -Inhalten, einschließlich:

• Türkische, chinesische, japanische, koreanische und andere nicht-lateinische Alphabete

• Sonderzeichen und Symbole

• Die richtige Kodierung gewährleistet die korrekte Anzeige in E-Mail-Clients

Umfassendes Etikettenmanagement

Der Server bietet einen vollständigen Satz von Tools zum Verwalten von Gmail-Labels:

• Etiketten erstellen : Erstellen Sie neue Etiketten mit anpassbaren Sichtbarkeitseinstellungen

• Beschriftungen aktualisieren : Benennen Sie Beschriftungen um oder ändern Sie ihre Sichtbarkeitseinstellungen

• Beschriftungen löschen : Vom Benutzer erstellte Beschriftungen entfernen (Systembeschriftungen sind geschützt)

• Suchen oder Erstellen : Holen Sie sich ein Etikett nach Namen oder erstellen Sie es automatisch, wenn es nicht gefunden wird

• Alle Labels auflisten : Alle System- und Benutzerlabels mit detaillierten Informationen anzeigen

• Optionen für die Beschriftungssichtbarkeit : Steuern Sie, wie Beschriftungen in Nachrichten- und Beschriftungslisten angezeigt werden

Zu den Einstellungen für die Beschriftungssichtbarkeit gehören:

• messageListVisibility : Steuert, ob das Label in der Nachrichtenliste angezeigt wird ( show oder hide ).

• labelListVisibility : Steuert, wie das Label in der Labelliste angezeigt wird ( labelShow , labelShowIfUnread oder labelHide )

Diese Funktionen zur Etikettenverwaltung ermöglichen eine anspruchsvolle Organisation von E-Mails direkt über Claude, ohne dass Sie zur Gmail-Oberfläche wechseln müssen.

Batch-Operationen

Der Server verfügt über effiziente Stapelverarbeitungsfunktionen:

• Verarbeiten Sie bis zu 50 E-Mails gleichzeitig (konfigurierbare Stapelgröße)

• Automatische Aufteilung großer E-Mail-Gruppen zur Vermeidung von API-Beschränkungen

• Detaillierte Erfolgs-/Fehlerberichte für jeden Vorgang

• Sanfte Fehlerbehandlung mit individuellen Wiederholungsversuchen

• Perfekt für die Massenverwaltung und Organisation von Posteingängen

Sicherheitshinweise

• OAuth-Anmeldeinformationen werden sicher in Ihrer lokalen Umgebung gespeichert ( ~/.gmail-mcp/ )

• Der Server verwendet den Offline-Zugriff, um eine dauerhafte Authentifizierung aufrechtzuerhalten

• Geben Sie Ihre Anmeldeinformationen niemals an die Versionskontrolle weiter und übergeben Sie sie nicht

• Überprüfen und widerrufen Sie regelmäßig ungenutzte Zugriffe in Ihren Google-Kontoeinstellungen.

• Anmeldeinformationen werden global gespeichert, sind aber nur für den aktuellen Benutzer zugänglich

Fehlerbehebung

1. OAuth-Schlüssel nicht gefunden

   • Stellen Sie sicher, dass sich gcp-oauth.keys.json entweder in Ihrem aktuellen Verzeichnis oder in ~/.gmail-mcp/ befindet.

   • Überprüfen Sie die Dateiberechtigungen

2. Ungültiges Anmeldeinformationsformat

   • Stellen Sie sicher, dass Ihre OAuth-Schlüsseldatei entweder web oder installed Anmeldeinformationen enthält

   • Überprüfen Sie bei Webanwendungen, ob die Umleitungs-URI richtig konfiguriert ist

3. Port wird bereits verwendet

   • Wenn Port 3000 bereits verwendet wird, geben Sie ihn bitte frei, bevor Sie die Authentifizierung ausführen

   • Sie können den Prozess über diesen Port finden und stoppen

4. Fehler bei Batchvorgängen

   • Wenn Batch-Operationen fehlschlagen, werden einzelne Elemente automatisch erneut versucht

   • Überprüfen Sie die detaillierten Fehlermeldungen auf bestimmte Fehler

   • Erwägen Sie eine Reduzierung der Batchgröße, wenn Sie auf eine Ratenbegrenzung stoßen.

Beitragen

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

Lizenz

MIT

Unterstützung

Wenn Sie auf Probleme stoßen oder Fragen haben, melden Sie bitte ein Problem im GitHub-Repository.