mega-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.
mega-outlook-mcp
The most-comprehensive cross-platform MCP server for local Microsoft Outlook automation. 64 tools across email, threading, calendar, contacts, tasks, notes, inbox rules, automatic replies, free/busy, the Global Address List, and Exchange-specific surface — all behind a single Python package that runs on both Windows and macOS.
The server is tooling only — scheduling and the agent loop live in your MCP client (LM Studio, Claude Desktop, or any MCP-compatible harness).
Why mega-outlook-mcp?
Two great community MCP servers already exist for Outlook:
Aanerud/outlook-desktop-mcp— 29 tools, Windows-only, Node.jshasan-imam/mcp-outlook-applescript— 49 tools, macOS-only, Node.js
mega-outlook-mcp is the union of both, plus more, in one Python package
with a unified Backend Protocol. Highlights:
One install for both OSes.
pip install mega-outlook-mcpworks the same on Windows and macOS; the right backend is selected at startup.Agent-friendly composite tools.
outlook_summarize_inbox,outlook_extract_action_items,outlook_find_unanswered,outlook_meeting_prep,outlook_relationship_graph, and more — single calls instead of N round trips.Exchange-specific surface neither reference repo covers. Out-of-office, signatures, inbox rules, free/busy lookup, room finder, GAL search, delegated mailboxes, public folders, mailbox quota.
Built-in compatibility self-test.
outlook_diagnosticsprobes every Outlook field this server depends on and tells you exactly which tools break if Microsoft renames something.
Related MCP server: Outlook Assistant
Tool catalog (64 tools)
outlook_get_emails_in_time_range, outlook_get_conversation_thread,
outlook_get_email_full_metadata, outlook_search_emails,
outlook_save_attachment, outlook_get_thread_metadata,
outlook_send_email, outlook_create_draft, outlook_reply,
outlook_reply_all, outlook_forward, outlook_mark_email_read,
outlook_set_email_flag, outlook_set_email_categories,
outlook_move_email, outlook_archive_email, outlook_delete_email,
outlook_junk_email, outlook_summarize_inbox,
outlook_extract_action_items, outlook_find_unanswered,
outlook_find_promised_actions, outlook_threadify,
outlook_relationship_graph
outlook_list_folders, outlook_create_folder, outlook_rename_folder,
outlook_move_folder, outlook_delete_folder, outlook_empty_folder
outlook_list_calendar_events, outlook_get_calendar_event,
outlook_create_calendar_event, outlook_update_calendar_event,
outlook_delete_calendar_event, outlook_respond_to_event,
outlook_meeting_prep
outlook_list_contacts, outlook_search_contacts, outlook_get_contact,
outlook_list_tasks, outlook_search_tasks, outlook_get_task,
outlook_list_notes, outlook_search_notes, outlook_get_note
outlook_get_mailbox_info, outlook_list_accounts,
outlook_get_unread_count, outlook_get_mailbox_quota
outlook_get_out_of_office, outlook_set_out_of_office,
outlook_get_signature, outlook_set_signature, outlook_list_rules,
outlook_toggle_rule, outlook_calendar_freebusy,
outlook_meeting_room_finder, outlook_gal_search,
outlook_list_delegated_mailboxes, outlook_list_public_folders
outlook_get_current_time, outlook_write_file, outlook_diagnostics
Install
pip install mega-outlook-mcpOr with uv / pipx:
uv tool install mega-outlook-mcp
# or
pipx install mega-outlook-mcppywin32 is installed automatically on Windows via a platform marker; nothing
extra is needed on macOS (osascript ships with the OS).
Wire up an MCP client
Add the server to your MCP client config. Examples:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"outlook": {
"command": "mega-outlook-mcp"
}
}
}LM Studio: Settings → MCP → add a server with command mega-outlook-mcp.
If the GUI app can't find mega-outlook-mcp on PATH (common on macOS), use the absolute path:
{
"mcpServers": {
"outlook": {
"command": "/Users/you/.local/bin/python3",
"args": ["-m", "mega_outlook_mcp.server"]
}
}
}Platform requirements
OS | Outlook | Notes |
Windows 10/11 | Outlook Desktop (classic) signed in |
|
macOS 13+ | Outlook for Mac classic (16.x) | "New Outlook" not supported — Apple sandboxing blocks the AppleScript surface; use the classic UI toggle |
First-call sanity check
Tell your agent:
Call
outlook_diagnostics, thenoutlook_get_mailbox_info.
outlook_diagnostics should return status: HEALTHY. If it returns
DEGRADED:<n>_fields or BROKEN, read affected_tools and notes for
the cause. Most common: Outlook is closed, or the user is on "New Outlook"
on macOS.
Future-proofing against Outlook updates
outlook_diagnostics probes every Outlook field this server depends on
against a baseline manifest at src/mega_outlook_mcp/baseline/outlook_baseline.json.
Run it on a schedule (launchd, Task Scheduler, cron) so you find out
about regressions before an extraction job silently degrades. The
recommended audit prompt for your agent harness is at
docs/inspection-prompt.md.
What this server does NOT do
No Microsoft Graph / OAuth — strictly local desktop Outlook
No
recall_message(destructive on recipients), no voting buttons (rare)No two-phase prepare/confirm pattern — that belongs in the agent prompt
No "New Outlook" support on either platform until Microsoft restores APIs
Related projects
License
MIT — see LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Hosted MCP server for your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA modular collection of MCP servers for automating virtual secretary tasks within Microsoft Outlook, including email management, calendar operations, contacts, tasks, and mailbox settings through Microsoft Graph API.5MIT
- AlicenseAqualityCmaintenance22 consolidated MCP tools for email, calendar, contacts, folders, rules, categories, and settings with safety controls (dry-run preview, rate limiting, recipient allowlists) and MCP annotations on every tool. Works with personal Outlook.com and work/school Microsoft 365 accounts.22504 npm39MIT
- AlicenseBqualityAmaintenanceMCP server that provides 62 tools to manage Outlook mail, calendar, contacts, and tasks for personal Microsoft accounts via Microsoft Graph API.711,327 PyPI41MIT
- AlicenseAqualityFmaintenanceAn MCP server that provides 49 tools to access Microsoft Outlook for Mac, enabling management of mail, calendar, contacts, tasks, and notes via AppleScript.4910MIT