Multi Mailbox Gmail for Codex

Ein Open-Source-Codex-Plugin zum Verbinden und Durchsuchen mehrerer Gmail- und Google-Workspace-Konten über freundliche Aliase wie @personal und @work.

Es erweitert Codex mit einem lokalen MCP-Server und postfachbewussten Anweisungen, sodass eine Anfrage wie Search @personal and @work for recent invoices beide ausgewählten Konten durchsucht und für jedes Ergebnis die Quell-Mailbox identifiziert. Der Mail-Zugriff ist schreibgeschützt.

Veröffentlichungsstatus

Das Repository ist öffentlich, ist aber derzeit eine Entwicklervorschau. Bis der gemeinsame OAuth-Client hinzugekommen ist, kann ein externer Benutzer das Codex-Plugin installieren, muss jedoch vor dem Verbinden eines Postfachs eigene Google-Desktop-OAuth-Anmeldedaten bereitstellen.

Related MCP server: multi-gmail-mcp-server

Installation in Codex

npx codex-marketplace add pkforge/multi-mailbox-gmail --plugin

Starten Sie nach der Installation eine neue Codex-Aufgabe, damit die Skill- und MCP-Tools des Plugins geladen werden.

Postfächer im Chat verbinden

Sobald der gemeinsame öffentliche OAuth-Client verfügbar ist, können Benutzer eine neue Codex-Aufgabe starten und:

Connect @personal
Connect @work

Jeder Befehl öffnet die Google-Kontoauswahl. Wählen Sie das Konto, das den jeweiligen Alias mit und gewähren Sie den schreibgeschützten Gmail-Zugriff. Wiederholen Sie das für jeden weiteren Account.

Der geplante öffentliche Build wird eine gemeinsame Google-Desktop-App-Identität verwenden, sodass Endbenutzer kein Google-Cloud-Konto oder Entwickler-Setup benötigen. Der OAuth-Flow läuft direkt zwischen diesem lokalen Plugin und Google: Es gibt kein Publisher-Backend, keine Datenbank, kein Analytics und keine Telemetrie. Das Plugin fordert nur https://www.googleapis.com/auth/gmail.readonly an. Refresh-Tokens werden mit DPAPI für den aktuellen Windows-Benutzer verschlüsselt; Aliaspeicher und E-Mail-Adressen der Konten werden als lokale Metadaten unter %LOCALAPPDATA%\MultiMailboxGmail gespeichert.

Aktuelle Einrichtung: eigenen OAuth-Client verwenden

Organisationen, die lieber ein eigenes Google-Cloud-Projekt verwenden möchten, können einen Desktop-OAuth-Client erstellen, die Gmail-API aktivieren und ihre heruntergeladene JSON-Datei entweder an die CLI übergeben oder MULTI_MAILBOX_GMAIL_OAUTH_CLIENT_FILE setzen.

npm.cmd install
npm.cmd run mailbox -- add personal C:\path\to\oauth-client.json
npm.cmd run mailbox -- add work C:\path\to\oauth-client.json
npm.cmd run mailbox -- list

Jeder add-Befehl öffnet die Google-Anmeldachen. Wählen Sie das Konto, das den Alias erhalten soll.

Löschen Sie lokal gespeicherte Anmeldedaten mit:

npm.cmd run mailbox -- remove work

Dies entfernt das lokal verschlüsselte Token. Sie können die App auch separat über die Google Konto-Sicherheitsseite widerrufen.

Verwendung im Chat

• Search @personal and @work for invoices from the last 90 days.

• Search @finance for unread mail with attachments.

• Search all mailboxes for subject:renewal newer_than:1y.

Das Plugin liefert jede Nachricht mit ihrem Quell-Alias, sodass identische Nachrichten dem richtigen Postfach zugeordnet bleiben.

Verbleibende Arbeit für die öffentliche Veröffentlichung

Vor der Nutzung von Connect @alias durch Nicht-Entwickler ohne Google-Cloud-Setup muss der Projektinhaber:

1. Die Konfiguration des Google-OAuth-Zustimmungsbildschirm abschließen.

2. Die OAuth-Client-Identität der installierten App erstellen und veröffentlichen.

3. Den Ende-zu-Ende-Verbindungsablauf von Codex mit mehreren Konten testen.

4. Den eingeschränkten Gmail-Lesezugriffsscope für Googles öffentliche App-Verifizierung einreichen.

Bei der Überprüfung kann Google eine Warnung zu einer nicht verifizierten App Anzeigen und das Limit für nicht verifizierte Benutzer durchsetzen. Der Quellcode und der Weg über einen eigenen OAuth-Client bleiben benutzbar.

Dies ist ein unabhängiges Community-Projekt und steht in keinem auf Google oder OpenAI.

Siehe Datenschutz, Sicherheit und das Google-Verifizierungspaket.