simple-email-mcp

# 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](https://claude.ai), [Claude Code](https://claude.com/claude-code), and any MCP-compatible client. ## Features - **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.) - **Compact MCP surface** — one `email` tool with lazy action discovery to reduce client context use ## Quick Start ### 1. Install ```bash pip install simple-email-mcp ``` Or from source: ```bash git clone https://github.com/mexican75/simple-email-mcp.git cd simple-email-mcp pip install . ``` ### 2. Create `accounts.json` ```json { "accounts": [ { "name": "personal", "address": "me@example.com", "password": "your-app-password", "provider": "gmail" } ] } ``` ### 3. Add to your client **Claude Code** (global, all projects): ```bash 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): ```json { "mcpServers": { "email": { "command": "simple-email-mcp" } } } ``` Or if running from source: ```json { "…