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

Tool	Description
listAccounts	List all configured email accounts (name, email, type)
listFolders	List all folders with message counts and unread counts
createFolder	Create a new subfolder under a specified parent

Email Search & Read

Tool	Description
searchMessages	Search by keyword (subject/sender/recipient), with date range and sort
getRecentMessages	Get recent messages by days, folder, and unread filter
getMessage	Read full message content (body, HTML, attachments)

Email Operations

Tool	Description
sendMail	Compose new email (opens Outlook compose window)
replyToMessage	Reply or reply-all (opens compose window)
forwardMessage	Forward with original attachments (opens compose window)
updateMessage	Mark read/unread, flag/unflag, move to folder, or trash
deleteMessages	Batch delete messages

Contacts & Calendar

Tool	Description
searchContacts	Search contacts by name or email
listCalendars	List all calendars with item count and writable status
createEvent	Create calendar event (opens Outlook event window)

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