TutorialGmailOutlookIMAP

Cómo conectar tu correo a un agente de IA en menos de 2 minutos (Gmail, Outlook, iCloud, Fastmail e IMAP)

Conecta tu correo a un agente de IA en menos de 2 minutos. Guía paso a paso para Gmail, Outlook, iCloud, Fastmail y cualquier buzón IMAP con MCP, sin almacenar correo.

Conecta tu correo a un agente de IA en menos de 2 minutos: Gmail, Outlook, iCloud, Fastmail e IMAP con MCP

Conectas tu correo a un agente de IA en dos pasos: conecta el buzón en el panel de MCP Emails y luego apunta tu agente a una única URL de endpoint. Con un cliente compatible con OAuth como claude.ai, eso es todo. Sin código, sin SDK, y tu correo no se almacena en ningún sitio: cada lectura y cada envío llega a tu proveedor en tiempo real y se descarta en cuanto el agente lo recibe.

Esta es la guía rápida. Elige tu proveedor más abajo, sigue los cuatro o cinco pasos y tendrás a Claude (o Cursor, o un script propio) leyendo y enviando correo real en aproximadamente el tiempo que tardas en leer este párrafo dos veces. Si prefieres la versión más a fondo de "qué es esto y si es seguro", empieza por la guía completa para dar acceso al correo a tu agente de IA.

El paso que comparten todos los proveedores: conecta tu cliente

Antes de tocar un proveedor, decide cómo hablará tu agente de IA con MCP Emails. Hay dos caminos y ambos usan el mismo endpoint y las mismas herramientas.

Camino A — cliente con OAuth (claude.ai, Claude Desktop, Cursor). Sin clave de API. Pegas una URL y apruebas un inicio de sesión:

  1. En claude.ai, ve a Personalizar → Conectores → Añadir conector.
  2. Pega el endpoint: https://www.mcpemails.com/api/mcp
  3. Pulsa Conectar, inicia sesión en tu cuenta de MCP Emails y aprueba los permisos que quieras (read:email, send:email, o ambos).

Eso es todo en el lado del cliente. Los tokens se limitan exactamente a lo que aprobaste, y puedes revocar la conexión desde el panel con un clic. Si quieres ver los pros y contras al detalle, lee OAuth frente a claves de API para el acceso al correo con IA.

Camino B — cliente con clave de API (Cline, JetBrains, cURL, agentes propios). Para cualquier cosa sin OAuth integrado:

  1. Ve a Panel → API Keys y crea una clave.
  2. Elige sus permisos (read:email, send:email).
  3. Cópiala una vez (solo se muestra una vez) y pásala como cabecera: Authorization: Bearer <tu-clave-api>, de nuevo contra https://www.mcpemails.com/api/mcp.

Si trabajas dentro de un editor, la configuración de correo para Cursor, Cline y VS Code cubre ese camino de principio a fin.

Ahora el buzón. Todos los proveedores de abajo empiezan igual: Panel → Inboxes → Connect Inbox y eliges tu proveedor.

Conecta cada proveedor

Gmail (OAuth)

El más rápido de todos, porque el trabajo lo hace Google.

  1. Panel → Inboxes → Connect Inbox → Gmail.
  2. Te redirige al inicio de sesión de Google. Elige la cuenta.
  3. Aprueba el acceso de lectura y envío en la pantalla de consentimiento.
  4. Vuelves al panel con el buzón conectado. Listo.

Nunca se intercambia una contraseña. MCP Emails guarda un token de OAuth cifrado y llama directamente a la API de Gmail. Las búsquedas usan los operadores nativos de Gmail (from:, is:unread, after:), así que tu agente puede ser preciso.

Outlook / Microsoft 365 (OAuth)

Misma forma que Gmail, distinto proveedor de identidad.

  1. Panel → Inboxes → Connect Inbox → Outlook / Microsoft 365.
  2. Inicia sesión con tu cuenta de Microsoft en la página de Microsoft.
  3. Aprueba los permisos.
  4. El buzón aparece conectado. El envío sale por Microsoft Graph, así que es un mensaje normal desde tu propia cuenta.

Si tu organización tiene acceso condicional o reglas de consentimiento de administrador, la guía de configuración de Outlook y Microsoft 365 explica los detalles del lado del administrador.

iCloud (contraseña específica de la app)

iCloud no ofrece OAuth a terceros, así que generas una contraseña específica de la app. Lleva un minuto más.

  1. Ve a appleid.apple.com, inicia sesión y abre la sección Inicio de sesión y seguridad.
  2. En Contraseñas específicas de app, crea una nueva y ponle la etiqueta "MCP Emails".
  3. Copia la contraseña generada (tiene la forma xxxx-xxxx-xxxx-xxxx).
  4. En Panel → Inboxes → Connect Inbox → iCloud, escribe tu dirección de iCloud y pega esa contraseña de app.

iCloud funciona sobre IMAP/SMTP por debajo, así que dispones del mismo conjunto de herramientas que el resto.

Fastmail (contraseña específica de la app, no OAuth)

Una corrección rápida si has leído documentación antigua: Fastmail se conecta con una contraseña de app, no con OAuth. No busques un botón de "Iniciar sesión con Fastmail": aquí no existe.

  1. En Fastmail, abre Settings → Privacy & Security → Integrations (o App Passwords).
  2. Crea una contraseña de app nueva. Dale acceso a correo (IMAP/SMTP) y ponle el nombre "MCP Emails".
  3. Copia la contraseña que genera Fastmail.
  4. En Panel → Inboxes → Connect Inbox → Fastmail, escribe tu dirección de Fastmail y pégala.

Eso es todo: desde el lado del agente, Fastmail se comporta exactamente igual que los demás proveedores IMAP.

IMAP genérico (Yahoo, Zoho, Yandex y los demás)

Cualquier servicio que hable IMAP/SMTP funciona con un solo conector. El patrón es idéntico al de iCloud y Fastmail: crea una contraseña de app en tu proveedor y luego pégala.

  1. En los ajustes de seguridad de tu proveedor, crea una contraseña de app (Yahoo, Zoho y Yandex la esconden en la seguridad de la cuenta). Usa una contraseña de app real, no la de tu inicio de sesión: la mayoría de proveedores ya bloquean el IMAP con contraseña normal.
  2. Panel → Inboxes → Connect Inbox → IMAP.
  3. Escribe tu dirección de correo y la contraseña de app. MCP Emails detecta los servidores habituales; si el tuyo es poco común, indica el host y el puerto de IMAP y SMTP que muestre tu proveedor.
  4. Guarda. El buzón se conecta y queda listo.

Para las particularidades de iCloud, Fastmail y la larga lista de servidores IMAP, el análisis a fondo de iCloud, Fastmail e IMAP es la referencia para resolver problemas.

Primera llamada: descubre y luego actúa

Sea cual sea el proveedor que elijas, el primer movimiento del agente siempre es el mismo. Haz que llame a inbox_list para descubrir qué hay conectado y obtener el inbox_id de cada buzón: el agente nunca copia y pega un UUID. A partir de ahí trabaja con un pequeño conjunto de herramientas consolidadas: email_read (con un action de list, read o search), email_compose (send, reply o forward) y email_organize para mover, marcar y archivar, además de folder, draft, schedule y contact_search:

{
  "tools": [
    "inbox_list",
    "email_read",
    "email_compose",
    "email_organize"
  ]
}

Una buena prueba rápida: pídele al agente "resume mis tres correos sin leer más recientes". Ejecutará inbox_list, luego email_read con action: "list" y unread_only: true y después email_read con action: "read" en cada uno. Si eso funciona, tu conexión está activa.

Una advertencia honesta que conviene dejar clara desde el principio: MCP Emails funciona por sondeo. No hay webhooks ni eventos push, así que un agente reacciona al correo nuevo comprobándolo según una programación, no recibiendo un aviso. Es el modelo adecuado para la mayoría de flujos, y así funcionan los patrones de clasificación y resumen del buzón.

Por qué es seguro hacerlo rápido

La rapidez aquí no viene de recortar en seguridad. El correo se obtiene en tiempo real en cada llamada y nunca se almacena: los cuerpos, asuntos y adjuntos se entregan al agente y se descartan de inmediato. Lo único que se conserva por buzón es tu token de OAuth o contraseña de app, cifrado con AES-256-GCM y descifrado solo dentro de una función aislada en el momento de la llamada. El envío siempre pasa por tu propio proveedor, así que la reputación de tu dominio sigue siendo tuya. Si quieres la arquitectura al detalle, lee por qué importa de verdad que "el correo nunca se almacene".

Para terminar

Eso es todo: una conexión de buzón, un endpoint, un puñado de herramientas. Todos los planes son ilimitados en buzones, llamadas y claves, y el plan Free no cuesta nada ni pide tarjeta; consulta los precios si necesitas límites de ráfaga más altos o SSO. ¿Listo para probarlo? Empieza gratis, conecta tu buzón y pega el endpoint en tu agente.

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.