gmail-mcp

Gmail second account MCP server

Lies und schreibe ein Gmail-Postfach von Claude.ai und Claude Code aus. Der Gmail-Connector von Claude.ai verwaltet nur ein einziges Konto; dieser Server ist also für das zweite Konto gedacht: Starte eine Instanz pro Postfach, und jeder Connector erreicht genau die Adresse, die ihm zugewiesen wurde.

Ein Postfach pro Instanz

Welches Konto eine Instanz bedient, ergibt sich aus GMAIL_CREDENTIALS_DIR; von diesem Prozess aus ist nichts anderes erreichbar. Diese Trennung ist der Zweck, keine Einschränkung: Ein Entwurf kann nicht im falschen Postfach landen, wenn der Server immer nur einen einzigen Satz Anmeldedaten besitzt.

Related MCP server: Gmail MCP Local Server

Werkzeuge

Lesen

Schreiben

Die beiden Sende-Werkzeuge sind als destruktiv markiert und weisen in ihren Beschreibungen darauf hin: Sie erreichen andere Personen und können nicht rückgängig gemacht werden. Der sichere Weg ist, mit gmail_create_draft einen Entwurf zu erstellen, ihn zu lesen und dann gmail_send_draft auszuführen, sobald eine Person den Text freigegeben hat.

Suchen

gmail_search akzeptiert dieselben Operatoren wie das Gmail-Suchfeld:

is:unread from:client.com
subject:invoice has:attachment newer_than:7d
label:important -in:trash

Es gibt pro Nachricht Kopfzeilen und einen Ausschnitt zurück, statt der vollständigen Textkörper, sodass eine breite Suche klein bleibt. Anschließend kannst du mit gmail_get_message oder gmail_get_thread fortfahren.

Wie es zusammenpasst

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8461
        |
   auth-server.js  :8462    handles the login and the tokens
        |
   gmail-mcp  :8460         the server itself, local only
        |
   gmail.googleapis.com

Der MCP hat kein eigenes Login und akzeptiert ausschließlich Verbindungen auf dem lokalen Rechner; alles, was ihn erreicht, hat die Anmeldung also bereits durchlaufen.

Einrichtung

Du benötigst einen Google-Cloud-OAuth-Client mit aktivierter Gmail-API und ein Refresh-Token für das Postfach. Das Verzeichnis mit den Anmeldedaten enthält zwei Dateien:

credentials.json        {"refresh_token": "..."}
gcp-oauth.keys.json     the downloaded OAuth client

gmail.modify ist der zu gewährende Bereich (Scope). Er umfasst Lesen, Labeln, Entwerfen und Senden. Reduziere auf gmail.readonly plus gmail.compose, wenn die Anmeldedaten selbst nicht senden können sollen.

git clone https://github.com/rollecode/gmail-second-account-mcp.git
cd gmail-second-account-mcp
uv venv && uv pip install -e .
npm install --omit=dev

CONFIG_DIR=~/.config/gmail-mcp node set-password.js 'your-password-here'
openssl rand -hex 32 > ~/.config/gmail-mcp/token
chmod 600 ~/.config/gmail-mcp/token

Trage YOUR_USER, den Hostnamen und das Anmeldedaten-Verzeichnis in systemd/*.service und nginx/gmail-mcp.conf ein, dann:

sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now gmail-mcp gmail-mcp-auth

sudo cp nginx/gmail-mcp.conf /etc/nginx/sites-enabled/gmail-mcp
sudo nginx -t && sudo systemctl reload nginx

Richte einen Tunnel oder einen HTTPS-Proxy auf 127.0.0.1:8461 aus. OAuth benötigt HTTPS.

Prüfe von außen: Die Discovery gibt Metadaten zurück, und /mcp ohne Token muss 401 zurückgeben.

curl https://your-host/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://your-host/mcp

Verbinden

Claude.ai: Einstellungen, Connectors, Benutzerdefinierten Connector hinzufügen, https://your-host/mcp, Client-ID und Client-Secret leer lassen.

Claude Code:

claude mcp add --transport http gmail https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/gmail-mcp/token)" --scope user

Lokal über stdio, ganz ohne Server:

GMAIL_CREDENTIALS_DIR=/path/to/creds claude mcp add gmail -- /path/to/.venv/bin/gmail-mcp

Einstellungen

Access-Tokens werden bei Ablauf im Speicher erneuert; nur das Refresh-Token wird von der Festplatte gelesen.

Danksagungen

Die Anmeldeschicht stammt von rollecode/obsidian-remote-mcp.