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 Anmeldeinformationen und erstellen Sie eine OAuth 2.0-Client-ID. Wählen Sie als Clienttyp „Desktop-App“.

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.