Outlook MCP Server

🤖 Outlook MCP Server

Gestión de correo electrónico impulsada por IA para Microsoft Outlook - Busca, redacta, organiza y reenvía correos en lote con comandos en lenguaje natural.

🤔 Elección del proyecto: Enfoque local vs. en la nube

Este proyecto utiliza win32COM, que funciona completamente en local con tus datos de Outlook (más seguro), mientras que nuestro nuevo Microsoft Graph MCP Server ofrece acceso en línea a todo el ecosistema de Microsoft 365 (más funciones). Elige según tus necesidades de seguridad y funcionalidad.

¿Por qué elegir este proyecto (win32COM)?

• ✅ Procesamiento local de datos: Todas las operaciones de correo se realizan localmente en tu equipo - ningún dato sale de tu máquina
• ✅ Seguridad mejorada: No se requiere autenticación en la nube ni tokens de API - funciona con tu instalación existente de Outlook
• ✅ Capacidad sin conexión: Accede y gestiona correos incluso sin conexión a internet
• ✅ Privacidad primero: Tus datos de correo nunca tocan servidores externos ni servicios en la nube

¿Por qué cambiar a Microsoft Graph API?

• ✅ Ecosistema completo de Microsoft 365: Accede a Correo, Calendario, Teams, OneDrive, SharePoint
• ✅ Soporte multiplataforma: Funciona en Windows, macOS, Linux y dispositivos móviles
• ✅ Autenticación moderna: OAuth 2.0 con flujo de código de dispositivo
• ✅ Rendimiento a escala en la nube: Sin dependencias de aplicaciones locales
• ✅ Acceso en línea: Funciona directamente con los servicios en la nube de Microsoft 365

---

🚀 Inicio rápido (2 minutos)

Lo que obtendrás

• Búsqueda inteligente de correos: "Encuentra correos sobre aprobación de presupuesto de la semana pasada"
• Redacción de correos con IA: Redacta respuestas con sugerencias conscientes del contexto
• Organización sencilla: Crea carpetas y mueve correos con comandos simples
• Reenvío en lote: Envía correos a cientos de destinatarios en minutos, no en horas

🤖 Comportamiento y flujo de trabajo de la IA

El agent_prompt_template.md define cómo se comporta el asistente de IA al gestionar correos:

• Propósito: Guiar el flujo de trabajo de la IA para búsqueda de correos, resúmenes y redacción
• Reglas clave: Lógica AND para búsquedas, visualización de correos de 5 en 5, confirmación antes de enviar
• Seguridad: Restricciones integradas garantizan el control del usuario y previenen acciones no autorizadas
• Cómo usarlo: Copia el contenido de la plantilla y úsalo para configurar tu asistente de IA

Consulta la plantilla para obtener las pautas completas de comportamiento y las definiciones del flujo de trabajo

¿Por qué elegir Outlook MCP Server?

Característica	Outlook MCP Server	Outlook tradicional	Complementos de Outlook
Búsqueda de correos con IA	✅ "Encuentra correos urgentes de mi jefe"	❌ Navegación manual de carpetas	⚠️ Solo búsqueda básica
Lenguaje natural	✅ "Muéstrame correos de presupuesto de la semana pasada"	❌ Se necesitan filtros complejos	⚠️ Palabras clave limitadas
Reenvío en lote de 100+ correos	✅ 2 minutos con CSV	❌ Más de 50 minutos manualmente	⚠️ Más de 20 minutos
Redacción de correos con IA	✅ Respuestas conscientes del contexto	❌ Redacción manual	⚠️ Plantillas básicas
Tiempo de configuración	✅ 2 minutos	✅ Ya instalado	❌ 10-30 minutos
Privacidad	✅ 100% procesamiento local	✅ Solo local	⚠️ Depende de la nube
Costo	✅ Completamente gratuito	✅ Incluido	💰 $5-50/mes
Curva de aprendizaje	✅ Lenguaje natural	✅ Interfaz familiar	⚠️ Nueva interfaz

Impacto en el mundo real

Antes: "Necesito reenviar este correo a 150 miembros del equipo..."

• Manual: Clic en Reenviar → Escribir cada correo → Enviar → Más de 2 horas perdidas
• Outlook tradicional: Crear lista de distribución → Añadir miembros → Reenviar → Más de 30 minutos

Después: "Reenvía este correo a todos en team.csv"

• Outlook MCP Server: Cargar CSV → La IA reenvía a todos → 2 minutos en total
• Tiempo ahorrado: ¡Más de 48 minutos por operación en lote!

Requisitos

• ✅ Python 3.8+
• ✅ Microsoft Outlook 2016+ (debe estar ejecutándose)
• ✅ Windows 10+

Instalación y configuración

Método 1: UVX (Recomendado - Dependencias automáticas)

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["--with", "pywin32>=226", "--with-editable", ".", "outlook-mcp-server"]
    }
  }
}

Método 2: Python estándar

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt
python -m outlook_mcp_server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["-m", "outlook_mcp_server"]
    }
  }
}

Método 3: Desde el código fuente (Desarrollo)

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"]
    }
  }
}

Prueba tu configuración ✅

Pregunta a tu asistente de IA: "Muéstrame mis correos recientes" - si funciona, ¡estás listo!

Solución de problemas de configuración 🛠️

Problemas comunes y soluciones:

Problema	Verifica esto	Solución
"uvx not found"	¿Está instalado UV?	pip install uv y luego reintenta
"python not found"	¿Está Python en PATH?	Usa la ruta completa como C:\Python39\python.exe
"Outlook not running"	¿Está abierta la ventana de Outlook?	Inicia Outlook primero y luego reinicia MCP
"Permission denied"	¿Tienes derechos de administrador?	Ejecuta la terminal como administrador
"Module not found"	¿Están instaladas las dependencias?	pip install -r requirements.txt

Verificación de configuración:

# Test your setup before connecting to AI
python -c "import outlook_mcp_server; print('✅ Server module loaded')"

# Test Outlook connection (Windows only)
python -c "import win32com.client; outlook = win32com.client.Dispatch('Outlook.Application'); print('✅ Outlook connected')"

Configuración específica por cliente MCP:

Claude Desktop:

1. Abre la configuración de Claude Desktop
2. Encuentra la sección "MCP Servers"
3. Haz clic en "Add Server" → "Custom"
4. Pega la configuración JSON
5. Reinicia Claude Desktop

Otros clientes MCP:

• Busca "MCP Configuration" o "Server Settings"
• Añade el JSON al archivo de configuración de tu cliente
• Normalmente se encuentra en: ~/.config/[client]/mcp.json

¿Sigue atascado? Reporta un problema con tu mensaje de error y los detalles de configuración.

🎯 Características principales

Gestión de correos

• Buscar: Encuentra correos por asunto, remitente, contenido o rango de fechas
• Redactar: Escribe nuevos correos con asistencia de IA
• Responder: Respuestas inteligentes que entienden el contexto de la conversación
• Reenviar en lote: Envía correos a cientos de destinatarios desde archivos CSV (¡ahorra horas!)

Gestión de carpetas

• Listar: Ve todas tus carpetas de Outlook
• Crear: Crea nuevas carpetas con comandos simples
• Mover: Organiza correos entre carpetas
• Eliminar: Elimina carpetas (¡cuidado - esto es permanente!)

📧 Reenvío en lote: Ahorra horas en la distribución de correos

Casos de uso reales

🎯 Actualizaciones de equipo

• Reenvía informes semanales a todo tu equipo
• Envía actualizaciones importantes a todos los miembros del equipo
• Distribuye actualizaciones de proyectos a las partes interesadas

📊 Campañas de marketing

• Envía boletines a listas de suscriptores
• Reenvía correos promocionales a segmentos de clientes
• Distribuye invitaciones a eventos a grupos de contactos

🏢 Comunicaciones corporativas

• Envía actualizaciones de políticas a todos los empleados
• Reenvía materiales de capacitación a los departamentos
• Distribuye anuncios a listas de distribución de la empresa

🔄 Cómo funciona

Flujo de trabajo simple

1. Carga de correos: "Muéstrame correos recientes" → Los correos aparecen en caché
2. Explora los resultados: Ve 5 correos por página con formato claro
3. Actúa: Responde, mueve, elimina u obtén un resumen con IA
4. Confirma antes de enviar: La IA siempre pregunta antes de enviar correos

Comportamiento del asistente de IA

• Entiende el lenguaje natural: "Encuentra correos urgentes de mi jefe"
• Muestra resúmenes de correos: Vista general de una línea + elementos de acción clave
• Redacta con contexto: Las respuestas entienden la conversación
• Nunca envía sin permiso: Siempre confirma antes de enviar

Flujo de trabajo de reenvío en lote

1. Prepara tu archivo CSV

email
john@company.com
jane@company.com
team@company.com

2. Usa lenguaje natural

"Forward this email to everyone in my contacts.csv"
"Send this project update to my team list"
"Distribute this newsletter to subscribers.csv"

3. La IA se encarga del resto

• Divide automáticamente listas grandes (máx. 500 por lote)
• Envía mediante CCO para proteger la privacidad de los destinatarios
• Añade tu mensaje personalizado antes del correo original
• Proporciona confirmación de entrega

Ahorro de tiempo

Reenvío manual: 100 correos × 30 segundos = 50 minutos Reenvío en lote: 30 segundos de configuración + 2 minutos de procesamiento = 2.5 minutos Ahorras: ¡47.5 minutos por lote!

🔧 Comandos comunes

Prueba estos con tu asistente de IA:

"Show me emails from last 3 days"
"Find emails about project updates" 
"Draft a reply to John about rescheduling"
"Create a folder called 'Work Projects'"
"Move email #3 to the Archive folder"

🛠️ Herramientas esenciales

Búsqueda y carga de correos

• list_recent_emails_tool(days=7) - Carga correos recientes (máx.: 30 días)
• search_email_by_subject_tool("search term") - Busca en asuntos de correos
• search_email_by_sender_name_tool("sender name") - Busca por remitente
• search_email_by_body_tool("search term") - Busca en el contenido de correos (más lento)

Acciones con correos

• view_email_cache_tool(page=1) - Explora correos cargados (5 por página)
• get_email_by_number_tool(email_number) - Obtiene detalles completos del correo
• reply_to_email_by_number_tool(email_number, "reply text") - Responde a un correo
• compose_email_tool("recipient@email.com", "subject", "body") - Envía un nuevo correo

Operaciones con carpetas

• get_folder_list_tool() - Úsalo siempre primero para ver las carpetas disponibles
• create_folder_tool("folder name") - Crea una nueva carpeta
• move_email_tool(email_number, "target folder") - Mueve un correo entre carpetas
• move_folder_tool("source", "target") - Mueve carpetas

Notas de seguridad

• Verifica siempre primero la lista de carpetas antes de mover o eliminar
• Los correos están en caché - usa los números de la caché para las operaciones
• Nunca envía sin confirmación - la IA siempre pregunta antes de enviar

⚡ Rendimiento

• Carga 100 correos en ~2 segundos
• Las búsquedas se completan en tiempo real
• Todo el procesamiento ocurre localmente (tus datos permanecen privados)

✅ Calidad y fiabilidad

Sistema robusto de validación

• Validación de entrada: Todas las entradas del usuario se validan antes del procesamiento
• Mensajes de error personalizados: Mensajes de error claros y accionables para problemas comunes
• Verificaciones de seguridad: Previene operaciones inválidas antes de que causen problemas

Pruebas integrales

• Más de 145 pruebas unitarias: Cada característica se prueba exhaustivamente
• Cobertura de configuración: Todos los ajustes y constantes están validados
• Manejo de casos límite: Probado contra entradas y escenarios inusuales
• Calidad continua: Las pruebas se ejecutan en cada cambio para garantizar la fiabilidad

Qué significa esto para ti

• Menos errores: La validación detecta errores antes de que causen problemas
• Mejores mensajes de error: Sabrás exactamente qué salió mal y cómo solucionarlo
• Operación fiable: Las pruebas integrales garantizan un rendimiento consistente
• Operaciones seguras: Las salvaguardas integradas previenen la pérdida accidental de datos

🛡️ Privacidad y seguridad

• 100% Procesamiento local: Ningún dato sale de tu computadora
• Sin servicios en la nube: Funciona completamente sin conexión
• Seguro por diseño: Utiliza tu instalación existente de Outlook

📚 ¿Necesitas ayuda?

• Consulta la plantilla de prompt para agentes para la configuración del asistente de IA
• Ve los ejemplos de configuración para diferentes métodos de instalación
• Lee la comparación Win32COM vs Graph API para detalles técnicos
• Revisa la guía de implementación de la API Win32COM para optimización de rendimiento
• Reporta problemas en el repositorio de GitHub

---