outlook-mcp

An MCP server that lets Claude (or any MCP client) read, write, reply to, forward and organize mail in classic Outlook on Windows, through Outlook's local COM interface.

Why: many school and work Microsoft 365 tenants block third-party apps unless an admin approves them, so the official connectors and the Microsoft Graph API are off the table. You can still sign in to the Outlook desktop app. This server talks to that already-signed-in Outlook, so it needs no admin consent, no app registration and no tokens.

中文简介：通过 Windows 上经典版 Outlook 的本地 COM 接口，让 Claude 读写、回复、转发、整理邮件。适用于学校或公司邮箱需要管理员授权、官方连接器连不上，但能在 Outlook 桌面版登录的情况。

Features

Safety defaults

• Drafts first. Every sending tool saves a draft unless it is called with send=true.

• No permanent deletion. delete_emails only moves mail to Deleted Items, and it refuses mail that is already there.

• Attach, never launch. The server connects only to an Outlook you already have open. Launching a hidden Outlook can hang forever on dialogs you can't see.

• Each tool carries MCP annotations (read-only / destructive), so clients can ask before running the risky ones.

Related MCP server: outlook-classic-mcp

Requirements

• Windows with classic Outlook (Microsoft 365 / Office desktop). The web-based "new Outlook" has no COM interface and is not supported.

• uv (Python 3.10+ is installed for you).

• Outlook must be open while you use the server.

Install

git clone https://github.com/Caesarcph/outlook-mcp.git
cd outlook-mcp
uv sync
cp config.example.json config.json   # then edit it, see below

Register with Claude Code (all projects)

claude mcp add -s user outlook -- uv run --directory "C:/path/to/outlook-mcp" server.py

Register with Claude Desktop (Chat)

Add this to %APPDATA%\Claude\claude_desktop_config.json, then restart Claude Desktop:

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

Use the absolute path to uv.exe (find it with where uv). GUI apps don't always inherit your terminal's PATH.

Configure

config.json is gitignored, so your addresses stay on your machine. Every field is optional.

Set OUTLOOK_MCP_CONFIG to load the config from another path.

Usage

Once it's registered, just ask in plain language:

• "Summarize this week's unread mail in my school inbox."

• "Reply to the email from the registrar, CC my advisor, and save it as a draft."

• "Forward the syllabus email to my personal address with the PDF attached."

• "Move all newsletters from last month into a folder called Newsletters."

Troubleshooting

License

MIT