Gmail MCP

Google Mail MCP

Eine Model Context Protocol (MCP) -Implementierung für die Gmail- API, die eine standardisierte Schnittstelle für die Verwaltung, das Senden und den Abruf von E-Mails bietet.

Merkmale

• Vollständige Gmail-API-Abdeckung, einschließlich Nachrichten, Threads, Labels, Entwürfen und Einstellungen
• Unterstützung beim Senden, Verfassen und Verwalten von E-Mails
• Etikettenverwaltung mit anpassbaren Farben und Sichtbarkeitseinstellungen
• Thread-Operationen für die Konversationsverwaltung
• Einstellungsverwaltung einschließlich Abwesenheitsnotiz, IMAP/POP und Spracheinstellungen
• Verlaufsverfolgung für Postfachänderungen
• Sichere OAuth2-Authentifizierung mit Google Cloud-Anmeldeinformationen

Voraussetzungen

Um diesen MCP-Server auszuführen, müssen Sie zunächst einen Google API-Client für Ihre Organisation einrichten, wobei jeder Benutzer ein Skript ausführt, um sein eigenes OAuth-Aktualisierungstoken abzurufen.

Google API-Client-Setup (einmal pro Organisation)

1. Gehen Sie zur Google Cloud Console .
2. Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus.
3. Aktivieren Sie die Gmail-API für Ihr Projekt.
4. Gehen Sie zu den Anmeldeinformationen und erstellen Sie eine OAuth 2.0-Client-ID. Wählen Sie entweder „Desktop-App“ oder „Webanwendung“ mit http://localhost:3000/oauth2callback als autorisierte Umleitungs-URI.
5. Laden Sie die OAuth-Schlüssel im JSON-Format herunter und speichern Sie sie als ~/.gmail-mcp/gcp-oauth.keys.json .
6. (Optional) Notieren Sie sich für die Remote-Serverinstallation (z. B. mit Smithery CLI) die CLIENT_ID und CLIENT_SECRET aus dieser Datei.

Client OAuth (einmal pro Benutzer)

1. Lassen Sie den Benutzer ~/.gmail-mcp/gcp-oauth.keys.json unter demselben Pfad auf seinen Computer kopieren.
2. Führen Sie npx @shinzolabs/gmail-mcp auth .
3. Es öffnet sich ein Browserfenster, in dem der Benutzer ein Profil auswählen, die angeforderten Bereiche überprüfen und genehmigen kann.
4. (Optional) Notieren Sie sich bei der Remote-Server-Installation den in der Erfolgsmeldung angegebenen Dateipfad (standardmäßig ~/.gmail-mcp/credentials.json ). Das REFRESH_TOKEN des Benutzers befindet sich hier.

Client-Konfiguration

Es gibt verschiedene Möglichkeiten, Ihren MCP-Client mit dem Server zu konfigurieren. Für die Einrichtung eines gehosteten/Remote-Servers verwenden Sie die Smithery-CLI mit einem Smithery-API-Schlüssel . Für die lokale Installation verwenden Sie npx oder erstellen Sie aus dem Quellcode. Jede dieser Optionen wird unten erläutert.

Smithery Remote Server (empfohlen)

Um einen Remote-Server zu Ihrer MCP-Client config.json hinzuzufügen, führen Sie den folgenden Befehl von der Smithery-Befehlszeilenschnittstelle aus:

Geben Sie Ihre CLIENT_ID , CLIENT_SECRET und REFRESH_TOKEN ein, wenn Sie dazu aufgefordert werden.

Smithery SDK

Wenn Sie Ihre eigene Agentenanwendung entwickeln, können Sie den hier enthaltenen Boilerplate-Code verwenden.

Lokale NPX-Installation

Um den Server lokal mit npx zu installieren, fügen Sie Folgendes zu Ihrer MCP-Client- config.json hinzu:

Aus der Quelle erstellen

1. Laden Sie das Repo herunter:

2. Installieren Sie Pakete und erstellen Sie sie mit pnpm (innerhalb des geklonten Repo):

3. Fügen Sie Folgendes zu Ihrer MCP-Client config.json hinzu:

Konfigurationsvariablen

Unterstützte Endpunkte

Benutzerverwaltung

• get_profile : Ruft das Gmail-Profil des aktuellen Benutzers ab
• stop_mail_watch : Beenden Sie den Empfang von Push-Benachrichtigungen
• watch_mailbox : Push-Benachrichtigungen für Postfachänderungen einrichten

Nachrichtenverwaltung

Nachrichten verwalten

• list_messages : Nachrichten mit optionaler Filterung auflisten
• get_message : Eine bestimmte Nachricht abrufen
• get_attachment : Ruft einen Nachrichtenanhang ab
• modify_message : Nachrichtenbezeichnungen ändern
• send_message : Senden Sie eine E-Mail-Nachricht an angegebene Empfänger
• delete_message : Eine Nachricht dauerhaft löschen
• trash_message : Nachricht in den Papierkorb verschieben
• untrash_message : Nachricht aus dem Papierkorb entfernen
• batch_modify_messages : Mehrere Nachrichten ändern
• batch_delete_messages : Mehrere Nachrichten löschen

Etikettenverwaltung

• list_labels : Listet alle Labels auf
• get_label : Holen Sie sich ein bestimmtes Label
• create_label : Erstellt ein neues Label
• update_label : Aktualisieren Sie ein Label
• patch_label : Teilaktualisierung eines Labels
• delete_label : Löscht ein Label

Thread-Verwaltung

• list_threads : E-Mail-Threads auflisten
• get_thread : Holen Sie sich einen bestimmten Thread
• modify_thread : Thread-Labels ändern
• trash_thread : Thread in den Papierkorb verschieben
• untrash_thread : Thread aus dem Papierkorb entfernen
• delete_thread : Einen Thread löschen

Entwurfsverwaltung

• list_drafts : Listen Sie Entwürfe im Postfach des Benutzers auf
• get_draft : Holen Sie sich einen bestimmten Entwurf nach ID
• create_draft : Erstellen Sie einen E-Mail-Entwurf in Gmail
• update_draft : Ersetzen Sie den Inhalt eines Entwurfs
• delete_draft : Löscht einen Entwurf
• send_draft : Senden Sie einen vorhandenen Entwurf

Einstellungsverwaltung

Automatische Weiterleitung

• get_auto_forwarding : Einstellungen für die automatische Weiterleitung abrufen
• update_auto_forwarding : Automatische Weiterleitungseinstellungen aktualisieren

IMAP-Einstellungen

• get_imap : IMAP-Einstellungen abrufen
• update_imap : IMAP-Einstellungen aktualisieren

POP-Einstellungen

• get_pop : POP-Einstellungen abrufen
• update_pop : POP-Einstellungen aktualisieren

Abwesenheitsnotiz

• get_vacation : Einstellungen für die Abwesenheitsnotiz abrufen
• update_vacation : Urlaubsantwort aktualisieren

Spracheinstellungen

• get_language : Spracheinstellungen abrufen
• update_language : Spracheinstellungen aktualisieren

Delegierte

• list_delegates : Listet Kontodelegierte auf
• get_delegate : Holen Sie sich einen bestimmten Delegierten
• add_delegate : Einen Delegierten hinzufügen
• remove_delegate : Einen Delegierten entfernen

Filter

• list_filters : E-Mail-Filter auflisten
• get_filter : Holen Sie sich einen bestimmten Filter
• create_filter : Einen neuen Filter erstellen
• delete_filter : Löscht einen Filter

Weiterleitungsadressen

• list_forwarding_addresses : Weiterleitungsadressen auflisten
• get_forwarding_address : Holen Sie sich eine bestimmte Weiterleitungsadresse
• create_forwarding_address : Eine Weiterleitungsadresse erstellen
• delete_forwarding_address : Löscht eine Weiterleitungsadresse

Senden-als-Einstellungen

• list_send_as : Liste der Sende-Aliase
• get_send_as : Holen Sie sich einen bestimmten Send-As-Alias
• create_send_as : Erstellen Sie einen Sende-Alias
• update_send_as : Aktualisieren Sie einen Sende-Alias
• patch_send_as : Teilaktualisierung eines Send-As-Alias
• verify_send_as : Bestätigungs-E-Mail senden
• delete_send_as : Löscht einen Sende-Alias

S/MIME-Einstellungen

• list_smime_info : Listet S/MIME-Konfigurationen auf
• get_smime_info : Holen Sie sich eine bestimmte S/MIME-Konfiguration
• insert_smime_info : Laden Sie eine neue S/MIME-Konfiguration hoch
• set_default_smime_info : Standard-S/MIME-Konfiguration festlegen
• delete_smime_info : Löscht eine S/MIME-Konfiguration

Beitragen

Beiträge sind willkommen und erwünscht! Bitte lesen Sie CONTRIBUTING.md für Richtlinien zu Problemen, Beiträgen und Kontaktinformationen.