IMAP MCP Pro MCP server

IMAP MCP Pro

An enterprise-grade Model Context Protocol (MCP) server that provides production-ready IMAP email integration with advanced reliability features, comprehensive monitoring, and secure account management.

Professional Edition — Enhanced fork with Level 1-3 reliability features, circuit breaker pattern, metrics, and bulk operations for commercial and large-scale deployments.

### 📜 License at a glance

Free for personal, educational, and non-profit use.

Paid commercial license required for any business, SaaS, revenue-generating, or multi-tenant deployment.

Contact for commercial licensing: colin.bitterfield@templeofepiphany.com

Full terms: LICENSE · License section below

Features

100+ MCP tools across email/folder/account/category/scoring/subscription/dns-firewall/usercheck/staging/cache/diagnostics — every IMAP4rev2 (RFC 9051) operation we use is exposed. See the full categorized list with exact count in docs/TOOLCATALOG.md (generated from the manifest on every build), or run imaplist_tools for the live catalog at runtime.

Core Features

• 🔐 Secure Account Management: Encrypted credential storage with AES-256 encryption
• 🚀 Connection Pooling: Efficient IMAP connection management
• 📧 Comprehensive Email Operations: Search, read, mark, delete emails
• ✉️ Email Sending: Send, reply, and forward emails via SMTP
• 📁 Folder Management: List folders, check status, get unread counts
• 🔄 Multiple Account Support: Manage multiple IMAP accounts simultaneously
• 🛡️ Type-Safe: Built with TypeScript for reliability
• 🌐 Web-Based Setup Wizard: Easy account configuration with provider presets
• 📱 15+ Email Providers: Pre-configured settings for Gmail, Outlook, Yahoo, and more
• 🔗 Auto SMTP Configuration: Automatic SMTP settings based on IMAP provider

Local Message Cache + Auto-installed Skills (v2.17.0+)

• Local SQLite header cache for fast sender enumeration. imapsyncfoldercache populates a per-folder cache; imapsearchcache runs groupbysender / bydomain / by_address queries against it in milliseconds. Validated end-to-end against a 1500-message INBOX: cold sync 1.7s, warm group-by-sender 4ms.
• UIDVALIDITY-aware delta sync: subsequent syncs only fetch new UIDs. Mailbox renumbering is detected automatically and triggers a full resync.
• Cache-miss is explicit: imapsearchcache returns a structured cache_miss error when a folder has not been synced — no silent IMAP fallback. The skill orchestrates the order.
• Auto-installed skills: bundled Claude skills (unsubscribe-cleanup in v2.17.0) are copied to ~/.claude/skills/imap-mcp-pro/ on server startup. Idempotent: skips when versions match, updates when the bundle is newer, preserves on-disk content with a higher version. Disable via IMAPMCPSKIPSKILLSINSTALL=1.
• Skill updates from public GitHub (v2.17.4+): two new tools, imapcheckskillupdates and imapupdate_skills, let you pull newer skill versions from this repo without reinstalling the .mcpb. No PAT needed — the default source is the MCP's own public repo. See docs/SKILLS.md for the full guide including the trust model.

v2.0 Reliability & Attachments (v2.15.0+)

Shortened. The full README is on GitHub.