outlook-mcp (bifurcación extendida)

Servidor MCP para Microsoft Outlook en Windows mediante win32com — permite a los asistentes de IA (Claude Code y otros clientes MCP) trabajar con correo electrónico, contactos, calendarios y tareas a través de una instancia local de Outlook. Sin Azure AD, sin Graph API, sin OAuth: controla el cliente de escritorio de Outlook mediante COM.

Esta es una bifurcación extendida de lihaokun/outlook-mcp (PyPI: outlook-mcp-server 0.1.1, MIT). La versión original incluye 14 herramientas; esta bifurcación incluye 21 y corrige tres tipos de errores que afectan en producción. No está publicada en PyPI: instala desde este repositorio (ver más abajo) y no ejecutes pip install -U outlook-mcp-server después, o PyPI la sobrescribirá.

Qué añade esta bifurcación respecto a la 0.1.1 original

Nuevas herramientas (7) — la original solo tenía listCalendars + createEvent para calendarios y nada para tareas:

• listEvents, getEvent, updateEvent, deleteEvent

• listTasks, createTask, updateTask

Correcciones:

• Zona horaria: las horas de los eventos se leen mediante StartUTC/EndUTC y se convierten con astimezone(). Las propiedades COM Start/End de Outlook informan la hora local con un desplazamiento falso de +00:00; el código ingenuo desplaza cada cita.

• Filtros de fecha seguros según configuración regional: los literales de fecha DASL/Jet se formatean con win32api.GetDateFormat(LOCALE_USER_DEFAULT, ...). Outlook analiza las fechas de filtro en la configuración regional del sistema: un 07/02/2026 con formato estadounidense se lee como el 7 de febrero en un sistema alemán.

• Disciplina del contenedor COM: CoInitialize/CoUninitialize están equilibrados en un único asistente (_run_com) en lugar de llamarse de forma improvisada.

• --version: informa la versión real instalada (la original tenía un error tipográfico que siempre mostraba dev).

Añadidos:

• Parámetro calendarPath en todas las herramientas de eventos, y emitido en cada diccionario de evento, para que los eventos sean direccionables en calendarios múltiples/compartidos.

• busyStatus y meetingStatus expuestos en los eventos.

• createEvent con calendarId guarda y luego mueve el elemento al calendario de destino y muestra el elemento movido.

• Los cuerpos de mensaje largos se truncan con una sugerencia para llamar a getMessage/getEvent para el cuerpo completo.

Modelo de seguridad (sin cambios respecto a la original): cada acción saliente — sendMail, replyToMessage, forwardMessage, createEvent, tareas — termina en .Display(), nunca en .Send(). El elemento se abre en Outlook y una persona hace clic en Enviar. El servidor no puede enviar nada por sí solo.

Related MCP server: MCP Outlook Tools

Lista completa de herramientas (21)

Requisitos

• Windows con el cliente de escritorio clásico de Outlook instalado y configurado (el servidor se conecta a una instancia en ejecución o inicia una mediante COM)

• Python 3.10+

Instalación

pip install git+https://github.com/K4uP/outlook-mcp.git

Regístrate con Claude Code (ámbito de usuario):

claude mcp add --scope user outlook -- outlook-mcp-server

Si outlook-mcp-server no está en PATH, usa la ruta completa al script de consola, p. ej. %LOCALAPPDATA%\Programs\Python\Python312\Scripts\outlook-mcp-server.exe. Reinicia Claude Code después y verifícalo con claude mcp list.

Problemas conocidos

• La configuración de mcpServers pertenece a ~/.claude.json (ámbito de usuario): ponerla en settings.json no hace nada.

• listEvents sin calendarPath mezcla calendarios compartidos/delegados; pasa la ruta de calendario explícita cuando necesites la disponibilidad de una persona.

• createEvent: omite calendarId para el calendario predeterminado; algunas configuraciones de Exchange fallan cuando el calendario predeterminado se aborda con un id. explícito.

• El correo "enviado" mediante sendMail solo se muestra: nada sale del equipo hasta que una persona pulsa Enviar en la ventana de Outlook.

Licencia

MIT — ver LICENCIA. Trabajo original con derechos de autor (c) 2026 lihaokun; extensiones y correcciones con derechos de autor (c) 2026 Rene S. Kaup.