Outlook Legacy MCP

Conecta Claude Desktop a instalaciones heredadas de Microsoft Outlook mediante automatización COM de Windows.

Este proyecto está diseñado especialmente para Outlook 2007 y entornos similares de Outlook de escritorio heredados donde las integraciones modernas de Outlook/Microsoft 365 pueden no estar disponibles o no ser prácticas.

Cómo funciona

Claude Desktop
      |
      | MCP
      v
Outlook Legacy MCP Server
      |
      | Windows COM / MAPI
      v
Microsoft Outlook Desktop
      |
      v
Configured Outlook Mail Profile

El servidor MCP se ejecuta localmente en el equipo Windows. No se conecta directamente a Exchange, IMAP, SMTP ni Microsoft Graph.

Related MCP server: Microsoft 365 MCP Server

Característica clave: sin credenciales de Outlook en el MCP

El servidor no solicita ni almacena:

• Nombre de usuario de Outlook

• Contraseña de Outlook

• Detalles del servidor Exchange

• Credenciales IMAP/SMTP

• Credenciales de Microsoft Graph

• Tokens OAuth

En su lugar, utiliza la aplicación de escritorio de Outlook y el perfil de correo ya configurado en el equipo Windows local.

Herramientas MCP actuales

Requisitos

• Windows

• Microsoft Outlook 2007 u otra versión de Outlook de escritorio compatible con COM

• Python 3.10+

• Claude Desktop

• Un perfil de correo de Outlook configurado

Outlook debe haberse abierto al menos una vez en el equipo para que su perfil esté configurado.

Instalación

Clona el repositorio:

git clone https://github.com/jatinpurba/outlook-legacy-mcp.git
cd outlook-legacy-mcp

Instala las dependencias:

pip install -r requirements.txt

También puedes instalarlas directamente:

pip install pywin32 mcp

Configurar Claude Desktop

Abre el archivo de configuración de Claude Desktop:

%APPDATA%\Claude\claude_desktop_config.json

Añade la siguiente entrada de servidor MCP. Reemplaza la ruta con la ubicación real del archivo Python en tu equipo:

{
  "mcpServers": {
    "outlook-legacy": {
      "command": "python",
      "args": [
        "C:\\path\\to\\outlook-legacy-mcp\\outlook_mcp_server.py"
      ]
    }
  }
}

Guarda la configuración y reinicia Claude Desktop por completo.

Las herramientas de Outlook deberían estar entonces disponibles para Claude.

Ejemplos de indicaciones

Una vez conectado, puedes pedirle a Claude cosas como:

Show me my latest 10 emails.

Show me my unread emails.

Read the latest email from John.

Create a draft response to this email.

Create a draft email to customer@example.com with the subject
"Project Update".

Ten especial cuidado con send_email, porque envía el mensaje a través de tu cuenta de Outlook configurada.

Seguridad y privacidad

Este servidor MCP se ejecuta localmente en tu equipo Windows.

El propio MCP no recopila ni almacena credenciales de Outlook. Accede al perfil de Outlook a través de la aplicación de Outlook instalada localmente.

Sin embargo, las herramientas MCP pueden acceder al contenido del buzón y pueden enviar correo electrónico. Ejecuta el servidor únicamente en un equipo de confianza.

Antes de utilizar el envío automatizado, revisa el destinatario, el asunto y el contenido de los mensajes generados por un sistema de IA.

Outlook puede mostrar un aviso de seguridad cuando un programa intenta enviar correo en tu nombre. Esta es una función de seguridad de Outlook.

Limitaciones

• Solo Windows

• Requiere Outlook de escritorio

• Requiere un perfil de Outlook configurado

• Utiliza automatización COM de Outlook para Windows

• Diseñado para uso local en lugar de implementaciones de servidor/headless

• Outlook puede necesitar estar en ejecución o ser iniciable para las operaciones COM

• Pueden aparecer avisos de seguridad de Outlook al enviar correo

• La implementación actual se centra en operaciones de correo electrónico

¿Por qué no Microsoft Graph?

Microsoft Graph es una excelente opción para entornos modernos de Microsoft 365.

Este proyecto se dirige a un caso de uso diferente: Outlook de escritorio heredado.

Si estás utilizando Outlook 2007 u otro entorno heredado donde las integraciones modernas basadas en Outlook/Graph no están disponibles o no son prácticas, este proyecto proporciona un puente MCP local basado en COM.

Arquitectura

El servidor utiliza Python, pywin32, automatización COM de Outlook y el SDK de Python de MCP.

El servidor MCP obtiene la aplicación de Outlook a través de COM y accede a su espacio de nombres MAPI. Por lo tanto, utiliza el perfil de Outlook ya configurado en el equipo en lugar de implementar un flujo de autenticación de servidor de correo independiente.

Desarrollo

Instala las dependencias:

pip install -r requirements.txt

Ejecuta el servidor:

python outlook_mcp_server.py

El servidor está diseñado para ser iniciado por un cliente compatible con MCP, como Claude Desktop.

Contribuciones

Se aceptan incidencias, mejoras, informes de compatibilidad y solicitudes de extracción (pull requests).

Si pruebas el proyecto con una versión diferente de Outlook heredado, incluye la versión de Outlook y la versión de Windows en tu incidencia.

Licencia

Licencia MIT. Consulta LICENSE.