Cómo conectar Email (IMAP/SMTP) a Microsoft Copilot vía MCP

💡 ¿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) + Microsoft Copilot

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.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

EMAIL_IMAP_HOST, EMAIL_IMAP_PORT, EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_USERNAME, EMAIL_PASSWORD

Paso 1 — Obtener credenciales

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).

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Email (IMAP/SMTP).
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse