outlook-classic-windows-mcp

Servidor MCP MVP para trabajar con un perfil de escritorio de Outlook clásico para Windows configurado localmente.

Este no utiliza Microsoft Graph, Outlook en la web, el nuevo Outlook para Windows ni API en la nube habilitadas por el administrador. Utiliza automatización COM de Windows contra el perfil/aplicación de escritorio de Outlook clásico disponible en la máquina donde se ejecuta el servidor MCP. Esto es útil si no quieres lidiar con tu soporte de TI o pedir la bendición de tu administrador.

Nota: este MCP es idiosincrásico para mi propio flujo de trabajo y requisitos. Se recomienda bifurcarlo y modificarlo—o pedirle a tu agente de codificación que lo haga por ti—para adaptar el MCP a tu propia configuración y caso de uso de Outlook.

Advertencia: Outlook clásico para Windows para usuarios de Microsoft 365 es compatible hasta al menos 2029. El nuevo Outlook se convierte gradualmente en el predeterminado o reemplazo. Este MCP solo será viable a corto/medio plazo. A largo plazo, ¡utiliza un MCP diferente que use API respaldadas por el administrador! Ver https://learn.microsoft.com/en-us/answers/questions/5554339/when-will-classic-outlook-end

Requisitos

• Windows

• Microsoft Outlook clásico de escritorio instalado y configurado

• uv

Instalación / ejecución

cd C:\Users\muhammad.menjeni\git\outlook-classic-windows-mcp
uv sync
uv run outlook-local-mcp

El servidor MCP habla stdio, por lo que está destinado a ser lanzado por un cliente MCP.

Ejemplo de configuración de Pi MCP

Añade una entrada de servidor local similar a esta en tu configuración de Pi MCP, ajustando la ruta si es necesario:

{
  "mcpServers": {
    "outlook-local": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\muhammad.menjeni\\git\\outlook-classic-windows-mcp",
        "run",
        "outlook-local-mcp"
      ]
    }
  }
}

Herramientas

search_email

Busca en el correo de Outlook por asunto y/o cuerpo.

Argumentos:

• query cadena: subcadena que no distingue mayúsculas/minúsculas para encontrar.

• folder cadena: carpeta a buscar. Predeterminado: Inbox. Puedes usar rutas como Inbox/Archive o Mailbox Name/Inbox.

• search_scope: all, subject o body. Predeterminado: all.

• max_results: número de coincidencias a devolver. Predeterminado: 10.

• max_items: elementos más recientes a inspeccionar en la carpeta. Predeterminado: 500.

• include_body_preview: incluir una vista previa corta del cuerpo. Predeterminado: true.

list_mail_folders

Lista las carpetas de Outlook disponibles para ayudar a elegir una ruta de carpeta.

create_leave_calendar_blocks

Crea dos elementos de calendario de Outlook no enviados para revisión de ausencias:

1. Un bloqueador personal marcado como Fuera de la oficina sin asistentes.

2. Una reunión de notificación marcada como Libre con los asistentes proporcionados.

No se envía nada. Por defecto, ambos elementos se guardan y se abren en Outlook para revisión/envío manual.

Argumentos:

• start_time cadena: fecha/hora de inicio, p. ej. 2026-09-01 08:00.

• end_time cadena: fecha/hora de fin. Para eventos de todo el día, esto se interpreta como un fin exclusivo, p. ej. un día desde 2026-09-04 00:00 hasta 2026-09-05 00:00.

• required_attendees lista/cadena: destinatarios adicionales de notificación. También se pueden usar valores predeterminados configurables.

• subject cadena: el predeterminado proviene de la configuración, inicialmente Amirul: On-Leave.

• body cadena: cuerpo del mensaje.

• optional_attendees lista/cadena: destinatarios opcionales de notificación.

• location cadena.

• display booleano: abrir los elementos guardados en Outlook. Predeterminado: true.

• confirmed booleano: debe ser true para crear realmente elementos de calendario de Outlook. Sin confirmación, la herramienta solo devuelve una propuesta.

get_leave_defaults

Muestra los valores predeterminados de ausencia actuales y la ruta de configuración.

set_leave_defaults

Persiste los valores predeterminados de ausencia, como el asunto y los destinatarios de notificación. Requiere confirmed=true antes de escribir la configuración.

infer_leave_recipients

Escaneo de solo lectura del correo local reciente de Outlook para inferir listas de distribución candidatas para notificaciones de ausencia. Devuelve candidatos y evidencia; no escribe configuración ni crea borradores.

resolve_recipients

Resuelve nombres, correos electrónicos o listas de distribución utilizando la resolución de destinatarios/libreta de direcciones de Outlook.

search_contacts

Busca en las carpetas de contactos locales de Outlook por nombre, correo electrónico, empresa, departamento o cargo.

Notas / limitaciones

• El primer acceso puede iniciar Outlook si no está ya en ejecución.

• Tu organización puede mostrar avisos del Modelo de Objetos de Outlook o bloquear la automatización por política.

• Este MVP busca escaneando elementos recientes de la carpeta, lo cual es simple y confiable pero no tan rápido como la búsqueda indexada de Outlook para carpetas muy grandes.