Conecta tu bandeja a OpenAI Codex
con un solo comando
Dale a Codex un buzón real. Lee, busca, redacta, envía, responde, reenvía, programa y organiza correo desde la CLI de Codex, la extensión del IDE o la app de escritorio de ChatGPT, en todas las bandejas que tengas conectadas.
Ejecuta codex mcp add mcpemails --url https://mcpemails.com/api/mcp. Codex detecta que el servidor admite OAuth, abre el navegador y tú apruebas el acceso en la pantalla de consentimiento de MCPEmails. La CLI, la extensión del IDE y la app de escritorio de ChatGPT comparten la misma configuración, así que basta con configurarlo una vez para las tres.
Cómo se conecta Codex: OAuth, sin clave de API
Codex ejecuta el flujo OAuth estándar de MCP contra este servidor. Se registra solo, ya sea con un documento de metadatos de client ID o mediante registro dinámico de clientes RFC 7591, así que no hay ningún client ID que crear, y se autoriza con código de autorización más PKCE usando S256. Nunca se transmite un secreto de cliente, y el token solo lleva los permisos que apruebas en nuestra pantalla de consentimiento. El token de acceso que recibe dura una hora y se renueva solo; aparece en Dashboard, API Keys como OAuth: seguido del nombre del cliente, y ahí es donde revocas la conexión.
El único valor que necesitas
Todo en esta página es una forma de llevar esta URL a OpenAI Codex.
| Campo | Valor |
|---|---|
| URL del servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticación | OAuth 2.1, código de autorización con PKCE. Sin clave de API. |
Cómo conectar OpenAI Codex a tu bandeja
Cuatro pasos. Los dos primeros son iguales para todos los clientes, el resto son propios de este.
Crea una cuenta gratis y conecta un buzón
Regístrate en mcpemails.com, sin tarjeta, y luego ve a Dashboard, Inboxes, Connect Inbox. Outlook y Microsoft 365 se conectan con el inicio de sesión de Microsoft; Gmail, iCloud, Fastmail, Yahoo, Zoho y Yandex requieren una contraseña de aplicación; cualquier otro se conecta por IMAP y SMTP estándar. El plan gratuito incluye una bandeja, para siempre.
Añade el servidor desde la CLI
Ejecuta el siguiente comando. Escribe una entrada [mcp_servers.mcpemails] con url en ~/.codex/config.toml, luego muestra Detected OAuth support. Starting OAuth flow… y abre tu navegador.
O añádelo en la app de escritorio o la extensión del IDE
En la app de escritorio de ChatGPT, abre Settings y luego MCP servers; en la extensión del IDE, abre el menú del engranaje y luego MCP servers. Elige Add server, escribe un nombre, elige Streamable HTTP, pega https://mcpemails.com/api/mcp, guarda y luego elige Restart (o Restart extension) y Authenticate.
Aprueba el acceso
Inicia sesión en MCPEmails en el navegador, elige Solo lectura, Estándar o Acceso completo en la pantalla de consentimiento y haz clic en Permitir acceso. Si el flujo del navegador no se ha iniciado, ejecuta codex mcp login mcpemails.
Compruébalo y pídele algo
Ejecuta codex mcp list, o /mcp dentro de una sesión de Codex, para ver el servidor. Después prueba con "resume lo que tenga sin leer de hoy". Codex llama primero a inbox_list para descubrir tus buzones, así que no hay ids que pegar.
codex mcp add mcpemails --url https://mcpemails.com/api/mcpDocumentación oficial de OpenAI Codex sobre servidores MCP remotos: https://learn.chatgpt.com/docs/extend/mcp?surface=cli
¿No sabes qué buzón conectar primero? Consulta la tabla de compatibilidad de proveedores
En qué suele tropezar la gente con Codex
Fíjate en qué tarjeta abre la pantalla de consentimiento
Codex pide los permisos que indica nuestro desafío 401, que es read:email, así que en algunos registros la pantalla de consentimiento se abre en Solo lectura. Para clasificar correo está bien. Si quieres que Codex redacte o envíe, elige Estándar o Acceso completo antes de hacer clic en Permitir acceso. Para ampliarlo más adelante, vuelve a ejecutar codex mcp login mcpemails y elige la tarjeta más amplia, o indica los permisos con --scopes, por ejemplo --scopes read:email,search:email,manage:drafts.
La CLI, la extensión del IDE y la app de escritorio comparten una configuración
En la misma máquina, las tres leen el mismo ~/.codex/config.toml, así que si añades el servidor en una aparece en las demás. Un proyecto también puede llevar su propio .codex/config.toml, que Codex solo lee en proyectos de confianza. ChatGPT en la web no lee este archivo en absoluto; para eso, usa la guía de ChatGPT.
En una máquina sin interfaz gráfica, prescinde del navegador local
En un servidor al que accedes por SSH, ejecuta codex mcp login mcpemails --no-browser: Codex muestra el enlace de inicio de sesión, lo abres en cualquier máquina y pegas la dirección a la que llega el navegador. En CI, crea una clave con permisos en Dashboard, API Keys, expórtala y pon en bearer_token_env_var de la entrada del servidor el nombre de esa variable (o pasa --bearer-token-env-var a codex mcp add). Codex la envía entonces en la cabecera Authorization, y la clave nunca queda en el archivo de configuración.
Mantén el tiempo de espera predeterminado de las herramientas
Por defecto, Codex espera 60 segundos por cada llamada a una herramienta (tool_timeout_sec). Basta incluso para trabajo masivo: mover o eliminar en una carpeta grande se detiene antes al llegar al límite de tiempo del propio servidor y devuelve un resultado marcado como partial, con los mensajes sin procesar listados en remaining_message_ids, para que Codex vuelva a llamar con esos ids. Si bajas mucho el tiempo de espera, la llamada puede cortarse antes de que llegue ese resultado.
Límites que conviene conocer
- Las solicitudes están limitadas a 100 por minuto, 1.000 por hora y 10.000 al día por clave, además del tope de acciones facturables de tu plan.
- El servidor funciona solo por petición y respuesta. No hay webhooks ni eventos iniciados por el servidor, así que el correo nuevo nunca despierta a tu agente por sí solo. Para reaccionar al correo entrante, consulta periódicamente según un horario.
- El correo se obtiene en vivo de tu proveedor en cada llamada y nunca se almacena. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, así que un token revocado o un cambio de contraseña del buzón corta el acceso de inmediato.
OpenAI Codex y el correo: preguntas resueltas
¿Cómo conecto el correo a OpenAI Codex?
Ejecuta codex mcp add mcpemails --url https://mcpemails.com/api/mcp. Codex detecta que el servidor admite OAuth, abre el navegador y tú apruebas el acceso en la pantalla de consentimiento de MCPEmails. A partir de ahí Codex tiene herramientas para leer, buscar, redactar, enviar, responder, reenviar, organizar y programar correo.
¿Cómo es la entrada de config.toml?
Dos líneas en ~/.codex/config.toml: una tabla llamada [mcp_servers.mcpemails] y url = "https://mcpemails.com/api/mcp". OAuth es lo predeterminado para un servidor con url, así que no hace falta nada más. Si escribes la entrada a mano, ejecuta codex mcp login mcpemails para iniciar sesión.
¿Necesito una clave de API para Codex?
No. Codex inicia sesión con OAuth, así que no escribes nada secreto en la configuración. Para máquinas sin navegador existe la opción de una clave con permisos: guárdala en una variable de entorno y apunta bearer_token_env_var a esa variable.
¿Qué buzones puede alcanzar Codex de esta forma?
Outlook.com y Microsoft 365 con el inicio de sesión de Microsoft, donde una cuenta del trabajo puede necesitar que un administrador de TI apruebe la aplicación una vez; Gmail, iCloud, Fastmail, Yahoo, Zoho y Yandex con una contraseña de aplicación; y cualquier otro buzón que hable IMAP y SMTP en los puertos estándar. El cliente los ve todos a través de la misma conexión: tu agente llama primero a inbox_list para descubrir cada buzón conectado y su id, así que no hay UUID que pegar en ningún sitio.
¿Puede Codex enviar correo sin que yo lo vea?
Solo si tú lo permites. El envío depende del permiso send:email, así que un token sin ese permiso no puede enviar nada. Además, el propietario de una bandeja puede exigir aprobación humana en el panel, que retiene cada envío, respuesta, reenvío, envío de borrador y envío programado hasta que una persona lo libera.
¿Se guarda mi correo en los servidores de MCPEmails?
No. Cada mensaje se obtiene en vivo de tu proveedor para la solicitud que lo pidió y se entrega directamente a tu cliente. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, para que las llamadas futuras puedan autenticarse. Eliminar la bandeja en el panel, o revocar el acceso en tu proveedor, corta la conexión al instante.
Dale a Codex una bandeja real
Un comando, un inicio de sesión en el navegador. Una bandeja gratis para siempre, sin tarjeta.