outlook-local-mcp
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-mcpEl 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:
querycadena: subcadena que no distingue mayúsculas/minúsculas para encontrar.foldercadena: carpeta a buscar. Predeterminado:Inbox. Puedes usar rutas comoInbox/ArchiveoMailbox Name/Inbox.search_scope:all,subjectobody. 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:
Un bloqueador personal marcado como Fuera de la oficina sin asistentes.
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_timecadena: fecha/hora de inicio, p. ej.2026-09-01 08:00.end_timecadena: fecha/hora de fin. Para eventos de todo el día, esto se interpreta como un fin exclusivo, p. ej. un día desde2026-09-04 00:00hasta2026-09-05 00:00.required_attendeeslista/cadena: destinatarios adicionales de notificación. También se pueden usar valores predeterminados configurables.subjectcadena: el predeterminado proviene de la configuración, inicialmenteAmirul: On-Leave.bodycadena: cuerpo del mensaje.optional_attendeeslista/cadena: destinatarios opcionales de notificación.locationcadena.displaybooleano: abrir los elementos guardados en Outlook. Predeterminado:true.confirmedbooleano: debe sertruepara 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 toolscreate_leave_calendar_blocksA
Create two unsent Outlook calendar items for leave review.
Creates:
A personal calendar blocker marked Out of Office with no attendees.
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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Your own AI reads, searches and drafts in your mailbox, on your Windows computer.
Manage Microsoft 365 email, calendar, contacts and inbox rules via the Graph API with OAuth 2.0.
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Related MCP Servers
- FlicenseAqualityDmaintenanceControls the Microsoft Outlook desktop app via COM automation, enabling email, calendar, and contact management without needing Graph API or Azure registration.14-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read, send, and manage Outlook mail locally on Windows via COM/MAPI, without cloud APIs.1MIT
- FlicenseNot gradedqualityCmaintenanceReads 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.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Microsoft Outlook Desktop (Classic) calendar and email through local COM automation, without Microsoft Graph or Entra registration.MIT