MCPAI agentsEmailTutorial

Cómo dar acceso al correo a tu agente de IA (la guía completa de 2026)

Da a tu agente de IA acceso de lectura y envío a una bandeja real por MCP: Gmail, Outlook, iCloud, Fastmail o IMAP. Cómo funciona, las herramientas, la seguridad y la configuración.

Cómo dar a tu agente de IA acceso al correo por MCP — MCPEmails

Para dar a un agente de IA acceso al correo, conectas tu bandeja a un servidor MCP y apuntas tu agente a una única URL de endpoint. El agente obtiene entonces un pequeño conjunto de herramientas para leer, buscar y enviar correo. Lo difícil no es el agente: es hacer esto sin filtrar tu contraseña a un prompt, a un log o a un almacén vectorial. Esa última milla es de lo que trata esta guía.

Si solo quieres el camino rápido: conecta una bandeja en el panel, pega el endpoint de MCP en claude.ai, Claude Desktop, Cursor o tu propio agente, y llama a inbox_list primero. El resto de este artículo explica qué ocurre en realidad, por qué importa el modelo de seguridad y cómo conectar cada proveedor compatible.

Qué significa de verdad "correo por MCP"

El Model Context Protocol es una forma estándar de exponer herramientas a un modelo de lenguaje sobre HTTP. Un servidor de correo MCP presenta tu bandeja no como IMAP en crudo, sino como un puñado de verbos tipados que el agente puede invocar: listar mensajes, leer uno, buscar, enviar, responder. El agente razona sobre esos verbos. Nunca toca el protocolo de buzón subyacente, y nunca ve tus credenciales.

Esa es toda la idea detrás de MCP Emails. Un endpoint, un conjunto de herramientas, cualquier cliente compatible con MCP. Si quieres la explicación de la arquitectura desde cero, el artículo complementario qué es un servidor de correo MCP lo cubre en lenguaje claro.

Por qué la última milla es difícil

Conectar un modelo al correo parece trivial hasta que lo intentas de verdad. Tres cosas muerden:

  1. La autenticación es distinta en cada proveedor. Gmail quiere OAuth con scopes específicos. Outlook quiere la identidad de Microsoft. iCloud y Fastmail quieren una contraseña de aplicación. Cada uno tiene su propio ciclo de refresco de tokens y sus propios modos de fallo.
  2. Las credenciales son radiactivas. Una contraseña de buzón en una transcripción de chat o en una línea de log es una brecha esperando a ocurrir. No puedes dejar que el modelo guarde el secreto.
  3. El correo tiene una forma pésima para los agentes. MIME, cabeceras de hilo, HTML frente a texto plano, adjuntos, carpetas que en realidad son etiquetas. El modelo necesita una respuesta limpia, no RFC 5322.

El arreglo ingenuo del bricolaje —darle al modelo una librería IMAP y tu contraseña— falla en las tres cosas a la vez. La mayoría de los repos de "servidor MCP de Gmail" en GitHub se quedan justo ahí.

Cómo lo resuelve MCP Emails

Cuatro decisiones de diseño hacen el trabajo pesado. Son la razón por la que confío en esto con mi propia bandeja.

El correo se obtiene en vivo y nunca se almacena

Cada llamada a una herramienta accede a tu proveedor en tiempo real: la API de Gmail, Microsoft Graph o IMAP/SMTP. Los cuerpos de los mensajes, los asuntos y los adjuntos se entregan al agente y se descartan al instante. Nada se cachea, indexa ni almacena. Lo único que se persiste por bandeja es la credencial necesaria para hacer la siguiente llamada. Si quieres la versión larga de por qué esto importa, lee por qué importa que "el correo nunca se almacena".

Las credenciales se cifran en reposo con AES-256-GCM

El token de OAuth o la contraseña de aplicación de cada bandeja se cifra antes de escribirse en la base de datos. El descifrado ocurre solo dentro de una Edge Function aislada, en el momento de la llamada, usando una clave que vive como secreto de entorno separado de la base de datos. Así, incluso una fuga de la base de datos entrega a un atacante texto cifrado, no tu bandeja.

El envío pasa por tu propio proveedor

Cuando el agente envía o responde, el correo sale por tu Gmail, tu Microsoft 365 o tu servidor SMTP. MCP Emails nunca reenvía desde su propio dominio. Tu entregabilidad y la reputación de tu dominio siguen siendo enteramente tuyas: nada de ruleta de carpeta de spam por IP compartida.

Es MCP estándar sobre HTTP

El servidor habla Streamable HTTP según la especificación MCP 2025-06-18. Ningún SDK que instalar, ningún cliente personalizado. Encaja en cualquier cosa que hable MCP.

Las herramientas que recibe tu agente

Un puñado de herramientas consolidadas y basadas en acciones cubren toda la superficie: leer, redactar, organizar, más otras para carpetas, programación y contactos. El agente siempre empieza con inbox_list para descubrir qué hay conectado y obtener el ID de cada bandeja: nunca codifica a fuego un UUID.

  • inbox_list — descubre las cuentas conectadas y sus capacidades
  • email_read (acción list) — paginado, lo más reciente primero, por bandeja
  • email_read (acción read) — texto plano parseado, HTML saneado opcional, adjuntos opcionales
  • email_read (acción search) — sintaxis nativa del proveedor (operadores de Gmail, KQL de Outlook, búsqueda de texto IMAP)
  • email_compose (acción send) — redacta con CC/BCC, HTML y adjuntos de hasta 10 MB en total
  • email_compose (acción reply) — lo mismo, y fija por ti las cabeceras de hilo (In-Reply-To, References)
  • email_organize — mover, eliminar, marcar o archivar (una acción por llamada)

Una limitación honesta que conviene dejar clara de entrada: esto es sondeo, no push. No hay webhooks. Para reaccionar al correo nuevo, tu agente sondea según una programación, por ejemplo email_read (acción list) con unread_only: true. Cualquier autorrespondedor que construyas funciona con un temporizador, no con un disparador instantáneo. La guía para construir un autorrespondedor muestra cómo hacerlo bien.

Una ejecución de triaje matutino se lee así:

{
  "step1": "inbox_list                  → finds your work Gmail",
  "step2": "email_read (action list)    → last 24h, unread_only",
  "step3": "email_read (action read)    → full body for anything urgent",
  "step4": "email_compose (action reply) → draft, or just summarize and wait"
}

Ninguna contraseña cruzó el cable. El agente sostenía capacidades, no credenciales. Para más ideas, mira 7 cosas que un agente de IA puede hacer con acceso a la bandeja y el recorrido más a fondo de triaje y resumen.

Proveedores compatibles y cómo se conecta cada uno

Conectas una bandeja una sola vez en Dashboard → Inboxes → Connect Inbox. Cómo te autenticas depende del proveedor.

Proveedores con OAuth (un clic)

Proveedores con contraseña de aplicación

iCloud, Fastmail, Yahoo, Zoho, Yandex y cualquier buzón IMAP genérico se conectan con una contraseña de aplicación en lugar de OAuth. Generas la contraseña en los ajustes de seguridad de tu proveedor y la pegas en MCP Emails. Las contraseñas de iCloud salen de appleid.apple.com; Fastmail es solo contraseña de aplicación (crea una en los ajustes de Fastmail). Todas viajan por el mismo transporte IMAP/SMTP y comparten un conjunto de funciones idéntico. El recorrido completo está en conectar iCloud, Fastmail o cualquier bandeja IMAP a Claude.

Conectar tu cliente de IA

Mismo endpoint, mismas herramientas, dos formas de entrar según si tu cliente habla OAuth.

Clientes con OAuth (sin clave de API)

claude.ai, Claude Desktop, Cursor y clientes similares se conectan con OAuth 2.0 Authorization Code + PKCE y Dynamic Client Registration de RFC 7591. En claude.ai es Customize → Connectors → Add connector, pega la URL del endpoint de MCP, pulsa Connect, inicia sesión en tu cuenta de MCP Emails y aprueba. Los tokens se limitan exactamente a lo que apruebes: read:email, send:email o ambos.

Clientes sin OAuth (clave de API)

Cline, JetBrains, scripts personalizados y cURL en crudo usan una clave de API con scopes. Crea una en Dashboard → API Keys, elige sus scopes y cópiala (se muestra una sola vez). Pásala como Authorization: Bearer <api-key>. La configuración completa para estos está en correo para agentes de IA en Cursor, Cline y VS Code, y el compromiso entre los dos enfoques se cubre en OAuth frente a claves de API para el acceso al correo con IA.

Sea como sea, revocas cualquier conexión desde el panel con un solo clic. Coge la URL exacta del endpoint de la documentación: cópiala de ahí en lugar de escribirla a mano.

¿Esto es seguro? Y los límites de tasa

Respuesta corta: sí, y el artículo ¿es seguro dar acceso al correo a un agente de IA? expone el caso completo. El modelo sostiene capacidades con scope, no tu contraseña; las credenciales están cifradas; nada se almacena; el envío se queda en tu proveedor; el acceso se revoca con un solo clic.

En cuanto a los límites de tasa, cada clave de API está limitada a 100 requests/min, 1.000/hora y 10.000/día en todos los planes. También hay un techo de ráfaga por workspace que escala con tu plan: 60/min en Free, 300/min en Solo, 1.000/min en Team. Cuando alcanzas un límite, el servidor devuelve un error reintentable con un valor retry_after en segundos. Respétalo. Y nunca reintentes a ciegas un envío con email_compose: enviarás duplicados.

Precios

Todo es ilimitado en cada plan: bandejas, llamadas a herramientas, claves de API, miembros del equipo. Los niveles solo difieren en la tasa de ráfaga, la retención de analíticas, las funciones de equipo y el soporte.

  • Free — $0 para siempre. Sin tarjeta. 60 req/min, analíticas de 7 días, soporte de la comunidad.
  • Solo — $12/month (o $120/year). 300 req/min, analíticas de 90 días, soporte por correo.
  • Team — $49/month (o $490/year). 1.000 req/min, roles de equipo y múltiples workspaces, SSO con SAML/OIDC más registro de auditoría, analíticas de 1 año, soporte prioritario.

Desglose completo en la página de precios.

Empieza ya

Conecta una bandeja, pega el endpoint en tu agente y llama a inbox_list. Ese es todo el onboarding. Empieza gratis u ojea el inicio rápido: tendrás un agente leyendo correo real en un par de minutos.

Asgeir Albretsen
Escrito por
Asgeir Albretsen

Asgeir builds MCPEmails — the bridge that lets AI agents read, search, and send real email over the Model Context Protocol. He writes about agents, email infrastructure, and developer experience.

@mcpemails

Dale una bandeja de entrada a tu agente

Conecta Gmail, Fastmail o cualquier cuenta IMAP a tu agente de IA en minutos.