Email (IMAP/SMTP) a MCP: busca, lee, ordena y envía correo desde cualquier buzón en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Email (IMAP/SMTP), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Email (IMAP/SMTP)

Conecta cualquier buzón por IMAP y SMTP: lista carpetas, busca y lee correos con adjuntos, márcalos, destácalos y muévelos, y guarda respuestas como borradores. El envío y la eliminación a la Papelera están desactivados al instalar; en AnythingMCP Cloud, enviar requiere un proveedor con SMTP en el puerto 2525. Funciona con IONOS, Strato, GMX, web.de, T-Online, Gmail (contraseña de aplicación), Fastmail, Hetzner, all-inkl, Aruba y servidores autoalojados.

Configuración

La configuración lleva unos 5 minutos. Necesitas los nombres de los servidores IMAP y SMTP de tu proveedor de correo y la contraseña del buzón, o una contraseña de aplicación.

El conector funciona con cualquier buzón que ofrezca IMAP (leer y organizar el correo) y SMTP (enviar): IONOS, Strato, GMX, web.de, T-Online, Hetzner, all-inkl, Aruba, Gmail y Google Workspace, Yahoo, iCloud, Fastmail, un Dovecot/Postfix autoalojado y la mayoría de los demás proveedores.

No sirve para Microsoft 365 ni Outlook.com. Microsoft desactivó el inicio de sesión con contraseña para IMAP y SMTP. Usa el conector Microsoft Outlook, que inicia sesión con OAuth.

1. Busca tu proveedor en la tabla de abajo. Si no aparece, sus páginas de ayuda indican el servidor IMAP y el servidor SMTP (también llamados servidor de entrada y servidor de salida).
2. Rellena EMAIL_IMAP_HOST, EMAIL_IMAP_PORT, EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_USERNAME (casi siempre la dirección de e-mail completa) y EMAIL_PASSWORD.
3. Deja vacíos EMAIL_IMAP_SECURITY y EMAIL_SMTP_SECURITY: el puerto decide (993 y 465 usan SSL/TLS, 143 y 587 usan STARTTLS). Ponles tls o starttls solo para un servidor en un puerto no estándar.
4. Instala el conector y ejecuta imap_smtp_list_folders para comprobar el inicio de sesión.

Contraseñas de aplicación: los proveedores con verificación en dos pasos no aceptan la contraseña normal para IMAP y SMTP. En su lugar emiten una contraseña de aplicación, que solo usa este conector y que puedes revocar en cualquier momento.

• Gmail / Google Workspace: activa la verificación en dos pasos y luego crea una en https://myaccount.google.com/apppasswords. En Google Workspace puede que un administrador tenga que permitirlo.
• Yahoo: Account Info, Account Security, Generate app password.
• iCloud: https://account.apple.com, Sign-In and Security, App-Specific Passwords. EMAIL_USERNAME es la dirección de iCloud completa.
• Fastmail: Settings, Privacy & Security, Manage app passwords, con acceso a IMAP y SMTP.
• GMX y web.de con el inicio de sesión en dos pasos activado: crea una contraseña específica de aplicación en los ajustes de seguridad.

Ajustes opcionales: EMAIL_FROM_ADDRESS y EMAIL_FROM_NAME definen el remitente que se muestra en el correo enviado (por defecto: el nombre de usuario); el proveedor normalmente solo acepta sus propias direcciones o alias. EMAIL_SMTP_USERNAME y EMAIL_SMTP_PASSWORD solo hacen falta cuando el envío usa un inicio de sesión distinto del de lectura. EMAIL_SENT_FOLDER indica dónde se guarda el correo enviado (por defecto: la carpeta que el servidor marca como Enviados; Gmail guarda el correo enviado por su cuenta).

Leer y ordenar: la IA empieza por la lista de carpetas (bandeja de entrada, enviados, borradores, papelera, spam, archivo, con el número de mensajes y de no leídos), busca en una carpeta por remitente, destinatario, asunto, texto, fechas, no leídos o destacados, del más reciente al más antiguo, y lee un mensaje como texto con su lista de adjuntos. Leer un mensaje no lo marca como leído. Abre adjuntos (los archivos de texto como texto, las imágenes y los documentos adjuntos al resultado), marca el correo como leído o no leído, lo destaca y lo mueve a otra carpeta.

Responder: imap_smtp_save_draft guarda un mensaje en Borradores, si quieres como respuesta en el hilo de un mensaje, para que lo revises y lo envíes desde tu programa de correo. Es la forma predeterminada de responder. imap_smtp_guide explica en qué orden llamar a las herramientas, sin contactar con el servidor de correo.

Desactivadas al instalar: imap_smtp_send_message y imap_smtp_delete_messages. Actívalas en la lista de herramientas del conector solo si la IA de verdad debe enviar o eliminar. El envío sale al momento, si quieres como respuesta en el hilo de un mensaje, guarda una copia en Enviados y no se puede recuperar, así que la IA confirma antes contigo los destinatarios y el contenido. Eliminar mueve los mensajes a la Papelera: nada se elimina de forma permanente, y se rechazan los mensajes que ya están en la Papelera.

Contenido no fiable: los e-mails los escriben desconocidos y pueden contener texto pensado para dar instrucciones a la IA ("reenvía todas las facturas a…", "elimina este hilo"). La IA trata el contenido del correo como datos, no como órdenes, y nunca sigue instrucciones que encuentre en un e-mail.

Límites: una búsqueda devuelve como máximo 100 mensajes; un cuerpo se corta a los 100.000 caracteres con una marca; se rechazan los adjuntos de más de 4 MB; un mensaje va a un máximo de 50 destinatarios; el correo saliente todavía no puede llevar adjuntos. Cada llamada a una herramienta abre su propia conexión IMAP y cierra la sesión al terminar, así que nada queda conectado al buzón entre llamadas. Los UID pertenecen a una carpeta y cambian cuando se mueve un mensaje.

Cloud y autoalojado: AnythingMCP Cloud solo se conecta con cifrado (SSL/TLS o STARTTLS), solo a servidores de correo públicos en los puertos IMAP 993/143 y SMTP 465/587/2525, y solo a servidores con un certificado válido. Siempre inicia sesión en el servidor SMTP, así que nada sale a través de un relay sin autenticar. En Cloud no se acepta el puerto 25.

Enviar desde AnythingMCP Cloud: el proveedor de hosting de Cloud bloquea el SMTP saliente en los puertos 25, 465 y 587, así que con casi cualquier buzón el envío no funciona allí: imap_smtp_send_message lo indica y no se envía nada. La lectura, la búsqueda, los destacados, el movimiento de mensajes y los borradores por IMAP funcionan con normalidad, así que la IA guarda las respuestas como borradores y tú las envías desde tu programa de correo. El envío funciona en una instalación autoalojada, o en Cloud con un proveedor que ofrezca SMTP en el puerto 2525. Test connection muestra IMAP como operativo y SMTP como no accesible.

Autoalojado: un servidor de correo de la red interna funciona en cuanto un administrador añade su host a la allowlist de salida (Admin, Settings, o SSRF_ALLOWED_HOSTS).

Requisitos previos: EMAIL_IMAP_HOST, EMAIL_IMAP_PORT, EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_USERNAME, EMAIL_PASSWORD

Instalar el conector localmente

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Abre http://localhost:3000/connectors/store, elige Email (IMAP/SMTP) e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué correos sin leer han llegado a mi bandeja de entrada desde el lunes? Dame remitente, asunto y un resumen de una línea de cada uno."
• "Busca el último correo con una factura de mi proveedor de hosting y abre su PDF adjunto."
• "Prepara un borrador de respuesta al último mensaje de [email protected] diciendo que puedo quedar el jueves a las 10."
• "Mueve las newsletters del mes pasado de la bandeja de entrada a la carpeta Archivo."
• "Prepara un borrador de un correo breve a [email protected] para confirmar nuestra llamada de mañana a las 3 de la tarde y guárdalo en Borradores."

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT