outlook-desktop-mcp

Turn your running Outlook Desktop into an MCP server with 29 tools. No Microsoft Graph API, no Entra app registration, no OAuth tokens — just your local Outlook and the authentication you already have.

Any MCP client (Claude Code, Claude Desktop, etc.) can then send emails, manage your calendar, create tasks, handle attachments, and more — all through your existing Outlook session.

Quick Start

1. Configure MCP Server (using uvx)

To use outlook-desktop-mcp, add the following snippet to your MCP client's config file (e.g., claude_desktop_config.json). This uses uvx to automatically install and run the server (requires Python 3.12+ on Windows):

{
  "mcpServers": {
    "outlook-desktop": {
      "command": "uvx",
      "args": [
        "outlook-desktop-mcp"
      ]
    }
  }
}

Requirements

• Windows — COM automation is Windows-only
• Outlook Desktop (Classic) — the OUTLOOK.EXE that comes with Microsoft 365 / Office. The new "modern" Outlook (olk.exe) does not support COM
• Python 3.12+
• Outlook must be running when the MCP server starts

Available Tools (29)

All tool descriptions are optimized for LLM tool discovery — Claude understands exactly how to use each one, what arguments to pass, and what to expect back.

💡 Important Configurations

Many tools support the following dynamic properties for advanced control:

• encoding (default: "utf-8"): Used in read_email, save_attachment, etc. Pass an encoding string (e.g., "euc-kr", "cp949") alongside your tool call to correctly fetch non-English characters in email subjects, bodies, or file names.
• folder_depth / max_depth (default: 4): Outlook MCP searches for your target folders recursively up to this limit to resolve names into objects. If you hide folders deep within your hierarchy, you can bump this parameter (e.g. 10) when calling tools like list_folders, list_emails, or move_email.

Email (9 tools)

Calendar (8 tools)

Tasks (5 tools)

Attachments (2 tools)

Categories (2 tools)

Rules (2 tools)

Out of Office (1 tool)

License

See LICENSE file.