codefuturist/email-mcp
View on GitHub ↗Email MCP server with full IMAP + SMTP support — read, search, send, manage, and organize email from any AI assistant via the Model Context Protocol
94 ★48 forksTypeScriptUpdated 3mo ago
What you need to know
Full-featured MCP email client over IMAP/SMTP exposing 47 tools, 7 prompts, and 6 resources for reading, sending, managing, scheduling, and analyzing email across multiple accounts.
Install
npx @codefuturist/email-mcp setup npm install -g @codefuturist/email-mcp docker pull ghcr.io/codefuturist/email-mcp:latest
Usage
- •email-mcp account add
- •email-mcp install
- •email-mcp scheduler install
- •Add {"command":"npx","args":["-y","@codefuturist/email-mcp","stdio"]} to mcpServers
Key features
- ✓Multi-account IMAP/SMTP with provider auto-detection (Gmail, Outlook, Yahoo, iCloud, Fastmail, ProtonMail, Zoho, GMX)
- ✓Read, search, send/reply/forward, drafts & templates, labels, bulk operations
- ✓Future email scheduling with OS-level daemon (launchd/crontab)
- ✓Real-time IMAP IDLE watcher with static rules and AI triage presets
- ✓Calendar (ICS) extraction and email analytics
- ✓Desktop/sound/webhook alerts with urgency routing
- ✓Experimental OAuth2 (Gmail/M365) and Docker support
Best for
Users who want a full email-client experience, not just read/send, wired into their AI assistant including triage, scheduling, and alerts
Caveats
- ⚠Requires Node.js >= 22
- ⚠Scheduler daemon must be installed for reliable scheduled email delivery
- ⚠OAuth2 support is experimental
- ⚠Attachment downloads capped at 5 MB with base64 encoding
- ⚠Inbox/triage presets rely on client MCP sampling
Platforms: macOS · Linux · WindowsClients: Claude Desktop · VS Code · Cursor · Windsurf · Zed · Mistral Vibe
Documentation ↗Reviewed 2026-08-11
Topics
aiclaudeemailimapimapflowllmmcpmcp-servermodel-context-protocolnodejsnodemailerprotonmailprotonmail-bridgesmtptypescript
- Stars
- 94★
- Forks
- 48
- Language
- TypeScript
- License
- LGPL-3.0
- Created
- 2026-02-18
- Last push
- 2026-05-20