outlook-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
outlook-mcp (extended fork)
MCP server for Microsoft Outlook on Windows via win32com — lets AI assistants
(Claude Code and other MCP clients) work with email, contacts, calendars, and
tasks through a locally running Outlook instance. No Azure AD, no Graph API,
no OAuth — it drives the Outlook desktop client over COM.
This is an extended fork of
lihaokun/outlook-mcp (PyPI:
outlook-mcp-server 0.1.1, MIT). Upstream ships 14 tools; this fork ships 21
and fixes three classes of bugs that bite in production. It is not published
to PyPI — install from this repository (see below) and do not run
pip install -U outlook-mcp-server afterwards, or PyPI will overwrite it.
What this fork adds over upstream 0.1.1
New tools (7) — upstream had only listCalendars + createEvent for
calendars and nothing for tasks:
listEvents,getEvent,updateEvent,deleteEventlistTasks,createTask,updateTask
Fixes:
Timezone: event times are read via
StartUTC/EndUTCand converted withastimezone(). Outlook's COMStart/Endproperties report local wall-clock time with a bogus+00:00offset; naive code shifts every appointment.Locale-safe date filters: DASL/Jet date literals are formatted with
win32api.GetDateFormat(LOCALE_USER_DEFAULT, ...). Outlook parses filter dates in the system locale — a US-formatted07/02/2026is read as February 7 on a German system.COM apartment discipline:
CoInitialize/CoUninitializeare balanced in a single helper (_run_com) instead of being called ad hoc.--version: reports the real installed version (upstream had a typo that always printeddev).
Additions:
calendarPathparameter on all event tools, and emitted in every event dict, so events are addressable across multiple/shared calendars.busyStatusandmeetingStatusexposed on events.createEventwithcalendarIdsaves, then moves the item to the target calendar and displays the moved item.Long message bodies are truncated with a hint to call
getMessage/getEventfor the full body.
Safety model (unchanged from upstream): every outbound action —
sendMail, replyToMessage, forwardMessage, createEvent, tasks — ends in
.Display(), never .Send(). The item opens in Outlook and a human clicks
Send. The server cannot send anything on its own.
Related MCP server: MCP Outlook Tools
Full tool list (21)
Area | Tools |
Accounts/folders |
|
| |
Contacts |
|
Calendar |
|
Tasks |
|
Requirements
Windows with the classic Outlook desktop client installed and configured (the server attaches to a running instance or starts one via COM)
Python 3.10+
Install
pip install git+https://github.com/K4uP/outlook-mcp.gitRegister with Claude Code (user scope):
claude mcp add --scope user outlook -- outlook-mcp-serverIf outlook-mcp-server is not on PATH, use the full path to the console
script, e.g.
%LOCALAPPDATA%\Programs\Python\Python312\Scripts\outlook-mcp-server.exe.
Restart Claude Code afterwards and verify with claude mcp list.
Known gotchas
mcpServersconfig belongs in~/.claude.json(user scope) — putting it insettings.jsondoes nothing.listEventswithoutcalendarPathmixes in shared/delegate calendars; pass the explicit calendar path when you need one person's availability.createEvent: omitcalendarIdfor the default calendar; some Exchange setups fail when the default calendar is addressed by explicit id.Mail "sent" via
sendMailis only displayed — nothing leaves the machine until a human presses Send in the Outlook window.
License
MIT — see LICENSE. Original work copyright (c) 2026 lihaokun; extensions and fixes copyright (c) 2026 Rene S. Kaup.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
A MCP server that works with Outlook Calendar to manage event listing, reading, and updates.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Related MCP Servers
- FlicenseCqualityDmaintenanceA powerful MCP server that enables AI assistants to interact with Microsoft Graph API for managing Outlook emails, Calendar events, OneDrive files, and Contacts through natural language commands.3556-
- AlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.15MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Outlook — enables AI assistants to access email, contacts, and calendars via Windows COM interface.1MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that gives AI assistants full access to Microsoft Outlook emails, calendar, and contacts via the Microsoft Graph API.2ISC