simple-email-mcp

A provider-agnostic MCP server for email (IMAP/SMTP). Works with any email provider — Purelymail, Gmail, Outlook, DomainFactory, or any standard IMAP/SMTP server.

Built for Claude Desktop, Claude Code, and any MCP-compatible client.

• Multi-account — manage multiple email accounts from different providers
• Read, search, list — full IMAP support with folder browsing
• Send emails — plain text, HTML, or both (multipart/alternative)
• Attachments — send via file path or base64-encoded inline data
• Download attachments — extract attachments from received emails as base64
• Calendar invites — send proper ICS invitations with Accept/Decline buttons
• Save to Sent — automatically saves sent emails to the Sent folder via IMAP
• Optional send gate — configurable confirmation code to prevent accidental sends
• International folders — handles UTF-7 encoded folder names (German, etc.)

pip install simple-email-mcp

Or from source:

git clone https://github.com/mexican75/simple-email-mcp.git
cd simple-email-mcp
pip install .

{
  "accounts": [
    {
      "name": "personal",
      "address": "me@example.com",
      "password": "your-app-password",
      "provider": "gmail"
    }
  ]
}

Claude Code (global, all projects):

claude mcp add email -s user -e ACCOUNTS_FILE=/path/to/accounts.json -- simple-email-mcp

Claude Desktop — add to config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "email": {
      "command": "simple-email-mcp"
    }
  }
}

Or if running from source:

{
  "mcpServers": {
    "email":