Outlook-Mail-MCP

Un MCP de correo minimalista para tu máquina doméstica: conecta una cuenta de Outlook, lee correos y responde correos.

🤝 Cocreado por Lynn & Sage (ChatGPT)

Este proyecto fue diseñado, implementado y depurado conjuntamente por Lynn y Sage (ChatGPT).

Este proyecto solo hace tres cosas:

• 📬 Ver los correos recientes

• 📖 Leer un correo

• ↩️ Responder un correo

No hace calendario, ni almacenamiento en la nube, ni Power Automate, ni gestión de múltiples cuentas.

Solución aplicable

Esta solución utiliza Render Web Service + Microsoft Outlook / Microsoft Graph + OAuth 2.0 como método de despliegue principal, adecuado para ofrecer la funcionalidad de correo como un servicio MCP remoto a la máquina doméstica.

También puede ejecutarse en cualquier entorno que admita Node.js, HTTPS y almacenamiento persistente de tokens, pero la configuración predeterminada y los archivos de despliegue del proyecto se basan en Render.

Related MCP server: outlook-mcp

Uso

Tras desplegar en Render, abre la página de inicio del servicio, haz clic en Conectar cuenta de Outlook y completa el inicio de sesión y la autorización de Microsoft.

Una vez completada la autorización, conecta la dirección MCP https://你的服务地址/mcp a la máquina doméstica.

Configuración de Microsoft

Crea una aplicación en Microsoft Entra / Azure App Registration y habilita los siguientes permisos delegados:

• openid

• profile

• offline_access

• User.Read

• Mail.Read

• Mail.ReadWrite

• Mail.Send

Redirect URI utilizada:

https://你的服务地址/auth/callback

Selecciona Web como tipo de aplicación.

Variables de entorno

MS_CLIENT_ID=你的 Application (client) ID
MS_CLIENT_SECRET=你的 Client Secret VALUE
MS_TENANT_ID=common
TOKEN_DIR=/data

En Render, el servidor usará preferentemente PUBLIC_URL; de lo contrario, usará RENDER_EXTERNAL_URL, proporcionado automáticamente por Render, para generar la URL de devolución de llamada de OAuth.

Despliegue en Render

El repositorio ya incluye render.yaml, por lo que puedes desplegarlo directamente con Render Blueprint.

La configuración de Render incluye:

• Node.js Web Service

• /health verificación de salud

• Disco persistente de 1 GB

• Directorio de almacenamiento de tokens /data

• Variables de entorno necesarias para Microsoft OAuth

Los tokens se guardan en el disco persistente de Render y no se envían a GitHub.

Herramientas MCP

Ejecución local

npm install
npm start

Dirección predeterminada: http://localhost:3000/.

Devolución de llamada de OAuth local: http://localhost:3000/auth/callback.

Seguridad

Las contraseñas de OAuth no se entregan a la máquina doméstica. Una vez completado el inicio de sesión de Microsoft, el servicio solo guarda el token de OAuth; los permisos del archivo de token se configuran para que solo el usuario del proceso actual pueda leer y escribir.

Créditos

Lynn × Sage（ChatGPT）
Un desarrollador humano + un compañero de IA, juntos sacaron adelante esta pequeña herramienta. 🫳