Skip to main content
Glama

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

Related MCP server: outlook-mcp

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.

Available Tools

8 tools
create_leave_calendar_blocksA

Create two unsent Outlook calendar items for leave review.

Creates:

  1. A personal calendar blocker marked Out of Office with no attendees.

  2. A meeting notification marked Free with the supplied attendees.

Nothing is sent. Items are saved locally, and by default opened in Outlook for manual review and sending.

Inputs: end_time (required), start_time (required), body, all_day, +6 more. Returns: object

get_leave_defaultsA

Return configurable defaults used by create_leave_calendar_blocks.

Inputs: no named parameters. Returns: object

infer_leave_recipientsB

Infer candidate leave-notification recipients/DLs from recent local Outlook email.

This is read-only. It scans recent mail subjects/bodies/recipients for distribution lists and department/team signals, then returns candidates for user confirmation.

Inputs: folders, max_results, max_items_per_folder. Returns: object

list_mail_foldersA

List Outlook store/folder paths to help choose the folder for search_email.

Inputs: max_depth. Returns: object

resolve_recipientsB

Resolve names, emails, or distribution lists using Outlook's address book/GAL.

Inputs: recipients (required). Returns: object

search_contactsB

Search local Outlook contact folders by name, email, company, or job title.

Inputs: query (required), max_results, max_folders_depth. Returns: object

search_emailA

Search locally configured Outlook desktop email by subject and/or body.

This scans the newest max_items messages in folder and returns up to max_results matches. It uses the local Outlook profile via COM, not Microsoft Graph or Outlook Web APIs.

Inputs: query (required), folder, max_items, max_results, +2 more. Returns: object

set_leave_defaultsB

Persist leave-calendar defaults. Requires confirmed=true because this writes config.

Inputs: notification_attendees (required), subject, confirmed. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 8 tools

    Disambiguation4/5

    Tools are mostly distinct, but three recipient-related tools (resolve_recipients, search_contacts, infer_leave_recipients) could cause some confusion regarding when to use each. However, their descriptions clearly differentiate (address book resolution vs. contact folder search vs. historical email inference), and the other tools are unambiguous.

    Naming Consistency5/5

    All tool names follow a strict verb_noun snake_case pattern (e.g., get_leave_defaults, search_email, create_leave_calendar_blocks). The pattern is predictable and consistent across all 8 tools, making it easy for an agent to infer naming conventions for hypothetical tools.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its domain of Outlook leave management and search. Each tool serves a distinct function in a cohesive workflow, and the count is within the ideal range without being overwhelming or sparse.

    Completeness4/5

    The tool surface covers the core leave workflow: configuration, calendar block creation, recipient inference/resolution, and search capabilities. Minor gaps exist—such as no update/delete for leave calendar blocks—but these are unsent drafts intended for manual review, so the current surface seems sufficient for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read, send, and manage Outlook mail locally on Windows via COM/MAPI, without cloud APIs.
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Reads and searches your local Microsoft Outlook desktop mailbox via COM, supporting folder listing, message/thread retrieval, attachment saving, bulk export, and draft creation without sending, requiring no OAuth or admin consent.
      -