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.js
• hasan-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-mcp works 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_diagnostics probes every Outlook field this server depends on and tells you exactly which tools break if Microsoft renames something.

Tool catalog (64 tools)

Install

pip install mega-outlook-mcp

Or with uv / pipx:

uv tool install mega-outlook-mcp
# or
pipx install mega-outlook-mcp

pywin32 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

First-call sanity check

Tell your agent:

Call outlook_diagnostics, then outlook_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

• Aanerud/outlook-desktop-mcp
• hasan-imam/mcp-outlook-applescript
• Model Context Protocol

License

MIT — see LICENSE.