outlook-mcp

MCP server for Outlook — enables AI assistants to access email, contacts, and calendars via Windows COM interface.

Built on the Model Context Protocol (MCP), works with Claude Code and other MCP-compatible clients.

Features

• Email: Search, read, send, reply, forward, flag, move, delete
• Contacts: Search by name or email
• Calendar: List calendars, create events
• Multi-account: Supports all accounts configured in Outlook
• Safe by design: Send/reply/forward opens Outlook compose window for user confirmation — never auto-sends
• Local only: All operations via local COM interface, no cloud API or OAuth needed

Requirements

• Windows with Outlook desktop client installed and running
• Python >= 3.10

Install

pip install outlook-mcp-server

Verify installation:

outlook-mcp-server --version

Usage with Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "outlook": {
      "command": "outlook-mcp-server"
    }
  }
}

Then restart Claude Code. The 14 Outlook tools will be available to Claude automatically.

Alternative: run from source

git clone https://github.com/lihaokun/outlook-mcp.git
cd outlook-mcp
pip install -e .

{
  "mcpServers": {
    "outlook": {
      "command": "uv",
      "args": [
        "--directory", "C:\\path\\to\\outlook-mcp",
        "run", "outlook-mcp-server"
      ]
    }
  }
}

Available Tools

Accounts & Folders

Email Search & Read

Email Operations

Contacts & Calendar

Safety

This server is designed with safety as a priority:

• No auto-send: sendMail, replyToMessage, forwardMessage, and createEvent all call .Display() instead of .Send() / .Save(). This opens the Outlook compose window so the user can review and confirm before sending.
• Outlook Object Model Guard: Outlook may show additional security prompts for send operations. This is expected behavior.
• Local only: All data stays on your machine. No external API calls, no cloud services, no OAuth tokens.

Technical Details

• COM interface: Uses pywin32 (win32com.client) to control Outlook
• MCP transport: stdio (standard input/output)
• Message ID: Uses Outlook's EntryID as unique identifier
• Search: Uses Items.Restrict() with DASL filters for efficient server-side filtering
• Internationalization: Automatically handles both "Inbox" and "收件箱" folder names

Related Projects

• mail-assistant — AI-powered mail assistant using MCP, works with Thunderbird and Outlook
• thunderbird-mcp — MCP server for Thunderbird

License

MIT