Multi Mailbox Gmail for Codex

Un plugin de Codex de código abierto para conectar y buscar en varias cuentas de Gmail y Google Workspace mediante alias descriptivos como @personal y @work.

Extiende Codex con un servidor MCP local e instrucciones que distinguen el buzón, de modo que una petición como Search @personal and @work for recent invoices busque en ambas cuentas seleccionadas e identifique el buzón de origen de cada resultado. El acceso al correo es de solo lectura.

Estado de la versión

El repositorio es público, pero actualmente es una vista previa para desarrolladores. Hasta que se añada el cliente OAuth compartido, un usuario externo puede instalar el plugin de Codex, pero debe aportar sus propias credenciales OAuth de escritorio de Google antes de conectar un buzón.

Related MCP server: multi-gmail-mcp-server

Instalación en Codex

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

Inicia una nueva tarea de Codex después de la instalación para que se carguen la habilidad del plugin y las herramientas MCP.

Conecta buzones en el chat

Cuando el cliente público OAuth compartido esté activo, los usuarios iniciarán una nueva tarea de Codex y dirán:

Connect @personal
Connect @work

Cada comando abre el selector de cuentas de Google. Elige la cuenta que debe ser propietaria de ese alias y aprueba el acceso de solo lectura a Gmail. Repite el proceso para todas las cuentas que necesites.

La compilación pública prevista utilizará una única identidad de aplicación de escritorio de Google, de modo que los usuarios finales no necesiten una cuenta de Google Cloud ni configuración de desarrollador. El OAuth se realiza directamente entre este plugin local y Google: no hay backend, base de datos, analítica ni telemetría. El plugin solo solicita https://www.googleapis.com/auth/gmail.readonly. Los tokens de actualización se cifran para el usuario actual de Windows con DPAPI; los alias y las direcciones de correo de las cuentas se almacenan como metadatos locales en %LOCALAPPDATA%\MultiMailboxGmail.

Configuración actual: usa tu propio cliente OAuth

Las organizaciones que prefieran su propio proyecto de Google Cloud pueden crear un cliente OAuth de escritorio, activar la Gmail API y, a continuación, pasar su JSON descargado a la CLI o establecer la variable MULTI_MAILBOX_GMAIL_OAUTH_CLIENT_FILE.

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

Cada comando add abre el inicio de sesión de Google. Elige la cuenta que debe ser propietaria de ese alias.

Elimina las credenciales almacenadas localmente con:

npm.cmd run mailbox -- remove work

Esto elimina el token cifrado local. Si lo deseas, puedes revocar la aplicación por separado desde la página de seguridad de la cuenta de Google.

Uso en el 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.

El plugin devuelve cada mensaje con su alias de origen, de modo que los mensajes idénticos siguen siendo atribuibles al buzón correcto.

Trabajo restante para la publicación pública

Antes de que los no desarrolladores puedan usar la aplicación Connect @alias sin tener que configurar Google Cloud, el propietario del proyecto debe:

1. Terminar la configuración de la pantalla de consentimiento de Google OAuth.

2. Crear y publicar la identidad del cliente OAuth de aplicación instalada.

3. Probar el flujo de conexión completo de Codex con varias cuentas.

4. Enviar el ámbito restringido de solo lectura de Gmail para la verificación pública de aplicaciones de Google.

Durante la revisión, Google puede mostrar una advertencia de aplicación no verificada y aplicar su límite de usuarios no verificados. El código fuente y la opción de aportar tu propio cliente siguen siendo utilizables.

Este es un proyecto comunitario independiente y no está afiliado ni respaldado por Google u OpenAI.

Consulta Privacidad, Seguridad y el paquete de verificación de Google.