Outlook (Microsoft 365 Mail and Calendar) a MCP — Pilota Outlook desde cualquier agente IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Outlook (Microsoft 365 Mail and Calendar), pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Outlook (Microsoft 365 Mail and Calendar)

Deja que tu IA trabaje en Outlook: busca y lee correos, archiva mensajes en carpetas, redacta borradores, envía y responde, consulta el calendario, crea y mueve reuniones y encuentra huecos libres con tus compañeros. Microsoft 365 y Outlook.com a través de Microsoft Graph, con tu cuenta de Microsoft.

Configuración

1. Abre el centro de administración de Microsoft Entra (entra.microsoft.com) o el portal de Azure y ve a Applications → App registrations → New registration.

2. Ponle un nombre a la app (por ejemplo "AnythingMCP Outlook") y elige los Supported account types. La elección decide qué va en MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (un solo inquilino): solo pueden iniciar sesión los usuarios de tu organización. Usa el Directory (tenant) ID de la página Overview de la app (un GUID) o tu dominio, por ejemplo contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multiinquilino): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common (cuentas profesionales, educativas y de Outlook.com) o consumers (solo Outlook.com).

   Si el valor no coincide con el tipo de cuenta, Microsoft rechaza el inicio de sesión (AADSTS50194 o AADSTS50020).

3. En Redirect URI elige la plataforma Web e introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.

4. Abre API permissions → Add a permission → Microsoft Graph → Delegated permissions y añade offline_access, User.Read, Mail.ReadWrite, Mail.Send y Calendars.ReadWrite. No los añadas como Application permissions: los permisos de aplicación darían a la app acceso a todos los buzones de tu inquilino sin que nadie inicie sesión. El conector no los necesita, trabaja como el usuario que inicia sesión. offline_access hace que Microsoft emita un refresh token; sin él, el conector deja de funcionar una hora después de autorizarlo.

5. Abre Certificates & secrets → New client secret. Copia el Value del secreto, no el Secret ID; solo se muestra una vez. Anota la fecha de caducidad: cuando el secreto caduca, el conector deja de funcionar hasta que crees uno nuevo y lo pegues.

6. Pega el Application (client) ID de la página Overview en MICROSOFT_CLIENT_ID, el valor del secreto en MICROSOFT_CLIENT_SECRET y el valor del inquilino del paso 2 en MICROSOFT_TENANT_ID, e instala el conector.

7. En la página del conector, haz clic en Authorize with Provider e inicia sesión con el buzón con el que debe trabajar la IA. El refresh token se guarda cifrado y los access tokens (válidos durante una hora aproximadamente) se renuevan automáticamente.

8. Empieza con outlook_get_me: muestra en qué buzón ha iniciado sesión el conector.

Consentimiento del administrador: estos permisos delegados normalmente no necesitan un administrador, pero muchas organizaciones desactivan el consentimiento de los usuarios. Si el inicio de sesión muestra "Need admin approval" (AADSTS65001 o AADSTS90094), un administrador del inquilino (por ejemplo un Global Administrator o un Cloud Application Administrator) abre una vez el registro de la app y hace clic en API permissions → Grant admin consent para la organización. Después, cualquier usuario puede autorizar. Un conector autorizado por un administrador sigue leyendo solo el buzón del propio administrador: cada conector trabaja para la cuenta que inició sesión.

Solo lectura: sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Mail.Read Calendars.Read, vuelve a autorizar y desactiva las herramientas que envían o escriben.

Errores frecuentes: 401 InvalidAuthenticationToken significa que la autorización se revocó o que el client secret caducó; pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 ErrorAccessDenied significa que falta un permiso del paso 4 o que no se dio el consentimiento. MailboxNotEnabledForRESTAPI significa que la cuenta no tiene buzón de Exchange Online (por ejemplo, un buzón local o un usuario sin licencia). outlook_get_free_busy no funciona con cuentas personales de Outlook.com.

El conector no elimina correos ni eventos y no gestiona archivos adjuntos, contactos, reglas del buzón, buzones de otros usuarios ni buzones compartidos.

Requisitos previos: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

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 Outlook (Microsoft 365 Mail and Calendar) e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT