Conecta tu bandeja a Claude Code
con un solo comando
Dale un buzón real a la CLI en la que ya vives. Clasifica el correo de la noche antes del standup, envía una nota de versión o convierte un hilo en una incidencia, sin salir de la terminal.
Ejecuta claude mcp add --transport http mcpemails https://mcpemails.com/api/mcp y autentícate en el navegador cuando Claude Code te lo pida. Esa es toda la configuración: sin clave de API y sin archivo de configuración que editar a mano.
Cómo se conecta Claude Code: OAuth, sin clave de API
Claude Code 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 Claude Code.
| 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 Claude Code 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
Ejecuta el comando de abajo. --transport http es el transporte Streamable HTTP, que es el que habla este servidor.
Autentícate
Ejecuta /mcp dentro de una sesión de Claude Code, elige este servidor y sigue el flujo en el navegador. Si el navegador no se abre solo, copia la URL que imprime.
Pide algo
Prueba con "resume todo lo no leído de hoy". Claude Code llama primero a inbox_list para descubrir tus buzones, así que no hay ids que pegar.
claude mcp add --transport http mcpemails https://mcpemails.com/api/mcpDocumentación oficial de Claude Code sobre servidores MCP remotos: https://code.claude.com/docs/en/mcp
¿No sabes qué buzón conectar primero? Consulta la tabla de compatibilidad de proveedores
En qué suele tropezar la gente con Claude Code
Claude Code aplaza las definiciones de herramientas MCP, y aquí eso es una ventaja
Por defecto, Claude Code carga solo los nombres de las herramientas y las instrucciones del servidor al iniciar la sesión, y obtiene el esquema completo cuando lo necesita. En la práctica, añadir este servidor cuesta una fracción del contexto que costaría un servidor MCP ingenuo, y una herramienta que nunca usas nunca te cuesta su esquema.
Limita la conexión a lo que necesita la sesión
La pantalla de consentimiento OAuth decide qué puede hacer la CLI durante toda la vida del token. Una sesión de programación que debe leer correo pero nunca enviarlo es un token sin send:email. Si más adelante quieres más, vuelve a conectar y aprueba el conjunto más amplio; nada escala por sí solo.
Un bucle de agente con permiso de envío es una combinación que conviene pensar
Claude Code funciona sin supervisión durante largos ratos, que es justo cuando un envío accidental hace más daño. Para eso hay dos interruptores: deja send:email fuera del token, o activa la aprobación humana en el panel para que cada envío, respuesta, reenvío y envío programado espere a una persona. La aprobación es por bandeja y se aplica sea cual sea el cliente que hizo la llamada.
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.
- El flujo OAuth necesita un navegador una vez. En una máquina sin interfaz gráfica, añade el servidor con una clave de API en un encabezado Authorization y sáltate el flujo por completo. Si ahí sí quieres OAuth,
--callback-portfija el callback en un puerto que puedas redirigir.
Claude Code y el correo: preguntas resueltas
¿Cómo conecto el correo a Claude Code?
Añade este servidor MCP por URL: claude mcp add --transport http mcpemails https://mcpemails.com/api/mcp. Luego ejecuta /mcp en una sesión y completa el inicio de sesión en el navegador. A partir de ahí Claude Code tiene herramientas para leer, buscar, enviar, responder, reenviar, organizar y programar correo.
¿Puedo usar una clave de API en lugar de OAuth?
Sí. Claude Code acepta un encabezado en el comando add, así que al pasar un encabezado Authorization con una clave bearer de Dashboard, API Keys te saltas el navegador por completo. Es la opción correcta en una máquina sin interfaz gráfica o en CI, donde no hay dónde completar un inicio de sesión.
¿Funciona en un devcontainer o por SSH?
Sí, con la salvedad de que el flujo OAuth necesita un navegador una vez. O completas el inicio de sesión donde haya un navegador, o añades el servidor con un encabezado de clave de API bearer y te saltas el flujo. Todo lo demás es HTTPS normal hacia un único endpoint.
¿Qué buzones puede alcanzar Claude Code 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 Claude Code 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.
Lleva tu bandeja a la terminal
Un comando, un inicio de sesión en el navegador. Una bandeja gratis para siempre, sin tarjeta.