email-mcp

MCP server for email + calendar via classic Outlook on Windows (COM automation). No Azure app registration, no OAuth — it just drives the Outlook desktop client you're already signed into.

Requirements

• Windows 10/11

• Classic Outlook desktop (configured with at least one account)

• Node.js 14+

• PowerShell (built-in)

The "new" Outlook for Windows does not expose COM. If you're on the new Outlook and can't switch back, this won't work for you.

Install / Run

Via npx straight from GitHub (no clone):

npx -y github:kerodkibatu/email-mcp

Or clone and run locally:

git clone https://github.com/kerodkibatu/email-mcp
cd email-mcp
npm install
node index.js

Claude Code / Claude Desktop config

Add to your .mcp.json (or claude_desktop_config.json):

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "github:kerodkibatu/email-mcp"]
    }
  }
}

First launch will be slow (~10s) while npx clones + installs. Subsequent launches hit the cache.

Tools

Downloading Attachments

The download_attachments tool extracts files from an email and saves them locally, returning the absolute folder path.

• Location: Files are saved under the user's Downloads folder: ~/Downloads/email-attachments/YYYY-MM-DD_sender-slug_subject-slug/.

• Inline Images: Logos and signature images are filtered out by default to avoid clutter. Set include_inline: true if you specifically need them.

• Idempotency: Re-running the tool on the same email safely skips re-downloading if the files already exist.

How it works

Each tool call writes a short PowerShell script to a temp file and executes it. The script attaches to a running Outlook instance via Marshal.GetActiveObject('Outlook.Application'), or launches one if none is running, then drives the MAPI namespace to read/write mail.

This means:

• Outlook must be installed (doesn't need to be open, but first call will launch it)

• Whatever account is signed into Outlook is what the MCP sees — no separate auth

• Sent mail appears in the user's Sent folder exactly as if they sent it manually

License

MIT — see LICENSE.