Conecta tu bandeja a Gemini CLI
con una sola entrada de configuración
Dale a Gemini CLI un buzón real. Lee, busca, envía, responde, reenvía, programa y organiza correo desde la terminal, en todas las bandejas que tengas conectadas.
Añade una entrada en mcpServers de ~/.gemini/settings.json usando el campo httpUrl con https://mcpemails.com/api/mcp. En la primera conexión, la CLI descubre los metadatos OAuth y abre por sí sola el flujo en el navegador.
Cómo se conecta Gemini CLI: OAuth, sin clave de API
Gemini CLI ejecuta el flujo OAuth estándar de MCP contra este servidor. Se registra solo 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 Gemini CLI.
| 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 Gemini CLI 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.
Abre tu settings.json
Edita ~/.gemini/settings.json para todos los proyectos, o .gemini/settings.json dentro de un proyecto concreto.
Añade el servidor
Añade la entrada de abajo en mcpServers. Aquí, el campo para un servidor Streamable HTTP es httpUrl.
Conecta
En la primera conexión, la CLI descubre OAuth automáticamente a partir de los metadatos del servidor y abre el flujo en el navegador. Aprueba los permisos que quieres que tenga la CLI.
{
"mcpServers": {
"mcpemails": {
"httpUrl": "https://mcpemails.com/api/mcp"
}
}
}Documentación oficial de Gemini CLI sobre servidores MCP remotos: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
¿No sabes qué buzón conectar primero? Consulta la tabla de compatibilidad de proveedores
En qué suele tropezar la gente con Gemini CLI
httpUrl es un campo distinto de url, y la diferencia es el transporte
En la configuración de Gemini CLI, httpUrl significa un servidor Streamable HTTP, que es lo que es este. Otras claves del mismo objeto seleccionan otros transportes. Un fragmento copiado de una guía de Cursor, que usa url, no te dará aquí una conexión Streamable HTTP que funcione.
El descubrimiento es lo que lo hace sin configuración, y empieza con un 401
No hace falta decirle a la CLI dónde autenticarse. Una llamada sin autenticar recibe un 401 cuyo encabezado WWW-Authenticate apunta a nuestros metadatos de recurso protegido, que indican el servidor de autorización, cuyos metadatos indican los endpoints de registro, autorización y token. Esa cadena es la razón de que no haya client ID que crear ni nada que pegar aparte de la URL.
Una CLI en una máquina compartida o sin interfaz gráfica pide la vía de la clave
El flujo en el navegador necesita un navegador. En un agente de compilación o una máquina compartida, la configuración honesta es una clave de API bearer limitada exactamente a lo que debe hacer esa automatización, guardada en el entorno y no en un archivo de configuración confirmado en el repo.
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.
Gemini CLI y el correo: preguntas resueltas
¿Cómo conecto el correo a Gemini CLI?
Añade una entrada en mcpServers de ~/.gemini/settings.json con httpUrl igual a https://mcpemails.com/api/mcp. En la primera conexión, la CLI descubre OAuth a partir de los metadatos del servidor y abre el flujo en el navegador. A partir de ahí tiene herramientas para leer, buscar, enviar, responder, reenviar, organizar y programar correo.
¿Uso url o httpUrl?
httpUrl. En la configuración de Gemini CLI esa clave selecciona el transporte Streamable HTTP, que es el que habla este servidor. Copiar una entrada url de otro cliente es el motivo habitual de que el servidor aparezca en la lista y no ofrezca ninguna herramienta.
¿Es lo mismo que el servidor MCP de Gmail que publica Google?
No. Google publica un servidor MCP de Workspace que cubre Gmail junto con sus otros servicios, y para Gmail solo, en un flujo de trabajo exclusivamente de Google, ese es el camino más corto. MCPEmails existe para el caso en que no todos los buzones son de Google, y en que la misma URL tiene que funcionar también en Claude, Cursor y ChatGPT.
¿Qué buzones puede alcanzar Gemini CLI 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 Gemini CLI enviar correo sin que yo lo vea?
Solo si tú lo permites. El envío depende del permiso send:email, así que una clave o 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 Gemini CLI una bandeja real
Una entrada de configuración, un inicio de sesión. Una bandeja gratis para siempre, sin tarjeta.