gmail-read-mcp

Schreibgeschützter Gmail-MCP-Server, der auf ein einzelnes Postfach beschränkt ist. Stellt über stdio zwei Tools bereit:

• list_emails – listet E-Mails, die in einem Datumsbereich empfangen wurden: Metadaten + Ausschnitt, älteste zuerst (max. 500)

• read_email – liest die vollständigen Header und den Textkörper einer E-Mail anhand der ID

Keine Schreib-, Sende-, Beschriftungs- oder Löschfunktionen. Jedes Ergebnis enthält einen jump_url-Deep-Link (rfc822msgid:-Suche), der die E-Mail für jeden öffnet, der im Postfach angemeldet ist. E-Mails, die vom Postfach selbst gesendet wurden (die Antworten des Teams), sind standardmäßig ausgeschlossen; Spam und Papierkorb sind immer ausgeschlossen.

Google-OAuth-Einrichtung

1. Erstellen Sie ein Google-Cloud-Projekt (getrennt von jedem Produktionsprojekt – der Zustimmungsbildschirm ist pro Projekt) und aktivieren Sie die Gmail-API.

2. Setzen Sie den OAuth-Zustimmungsbildschirm auf Intern (überspringt die Überprüfung des eingeschränkten Bereichs für den gmail.readonly-Bereich).

3. Erstellen Sie einen OAuth-Client vom Typ Desktop-App und laden Sie die Client-JSON herunter.

4. Führen Sie den einmaligen Zustimmungsablauf aus, während Sie als Zielpostfach angemeldet sind:

node scripts/gmail-oauth-once.mjs <path-to-client-secret.json>

Er gibt das Aktualisierungstoken und das Postfach aus, an das es gebunden ist.

Das Aktualisierungstoken läuft nicht ab, aber Google widerruft Tokens mit Gmail-Bereich, wenn sich das Kontopasswort ändert. Wenn der Server mit invalid_grant fehlschlägt, führen Sie Schritt 4 erneut aus und ersetzen Sie GMAIL_REFRESH_TOKEN.

Related MCP server: Gmail MCP Server

Lokale Einrichtung

cp .env.example .env
# Fill in GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, GMAIL_REFRESH_TOKEN
npm install
npm start

Testen

npm test