MiniMail MCP Server enables sending, receiving, and managing emails via multiple providers, with AI-assisted features, automation, and a web dashboard.
Core Email Operations
Send emails via SMTP/IMAP (Gmail, Outlook, ProtonMail), transactional APIs (SendGrid, Mailgun, Resend, Amazon SES), local testing servers (MailHog, Mailpit), or webhooks (Slack, Discord, Telegram) — with HTML, CC, and BCC support
Check inbox from IMAP or local testing servers, with filters for folder, unread status, sender, and subject
Fetch full email detail, search emails (IMAP full-text), delete emails, and mark as read
Service Management
Dynamically configure, list, remove, and test SMTP, API, local, and webhook services at runtime
Check connectivity and credential health for one or all services
AI & Automation
AI-powered assistance: Compose via natural language, rewrite emails with style/length/mood controls, auto-generate subject lines
Agentic workflows: Multi-step email planning via LLM sampling (Anthropic, OpenAI, Ollama, Google)
Auto-reply: Rule-based and AI-powered auto-responders with spam detection and spoof mode
Mail Watcher: Background IMAP polling that triggers webhook notifications
Management & Organization
Draft management: Save, edit, and send drafts
Folder management: Create, rename, delete IMAP folders
Contact import: CSV, vCard, Google People API, Microsoft Graph API, plus curated lists (US Congress, EU, Austria)
Bulk send: Multiple recipients with rate limiting and anti-spam safeguards
Mailing list presets: Configure newsletter folders and fetch latest messages
Web Dashboard & Testing
Full React SPA at localhost:10812 with inbox, compose, search, AI chat, auto-reply, services, settings, and help pages
Mail Lab: Throwaway SMTP server with AI-generated test messages
Creative workflows: Generate love letters, complaints, ASCII art, and SVG cards
Dual transport: Claude Desktop via stdio + web UI via HTTP
Native desktop app (Tauri 2.0) bundling the webapp and Python backend
Security: Two-layer prompt injection defense (Unicode stripping + safety boundary wrapping)
Enables sending transactional emails using the Amazon SES (Simple Email Service) platform.
Allows forwarding or sending email notifications directly to Discord channels as messages.
Integrates with GitHub to convert emails into comments for issues and pull requests.
Supports sending and receiving emails through Gmail using SMTP and IMAP with App Password authentication.
Enables email sending and inbox management for iCloud Mail accounts using standard email protocols.
Provides transactional email delivery and management through the Mailgun developer-friendly API.
Supports sending and checking emails on ProtonMail via direct SMTP/IMAP or through the ProtonMail Bridge.
Enables email sending and management through the Resend modern transactional email API.
Supports enterprise-grade email delivery and management via the SendGrid API.
Allows sending email alerts and notifications directly to Slack channels using incoming webhooks.
Enables forwarding email content and notifications to Telegram bots.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MiniMail MCP Server Send an email to sarah@example.com about the project kickoff"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A full-featured email server for MCP clients. Send and receive mail through SMTP/IMAP, transactional APIs (SendGrid, Mailgun, Resend), local test servers (MailHog), and webhooks (Slack, Discord). Includes a web dashboard with AI-assisted compose, a throwaway SMTP lab, folder management, contact import, background mail watching, and creative AI workflows (love letters, complaints, ASCII art, SVG cards).
v0.4.1 -- 148 tests passing, 39 MCP tools, FastMCP 3.4+, dual transport (stdio + HTTP).
.\start.ps1Opens the web dashboard at http://localhost:10812. Backend runs on port 10813.
Requirements: Python 3.12+, uv. Start configuring services from the Settings page.
For Claude Desktop setup, MCPB packaging, and manual configuration see docs/quickstart.md.
Related MCP server: io.github.p-w-4-z/inbox-mcp
Type | Providers | Guide |
SMTP/IMAP | Gmail, Outlook, Yahoo, iCloud, ProtonMail | |
Transactional APIs | SendGrid, Mailgun, Resend, Amazon SES | |
Local Testing | MailHog, Mailpit, MailCatcher, Inbucket | |
Webhooks | Slack, Discord, Telegram |
Document | Contents |
Installation, Claude Desktop setup, first email | |
All env vars, mailing lists, dynamic config | |
Full 39-tool reference with REST surface | |
Architecture, commands, contribution patterns | |
Symptom lookup, diagnostics endpoints | |
Prompt injection defense architecture | |
Background IMAP polling + webhook notifications | |
Integrate with robofang for TTS/light alerts | |
Gmail app password setup | |
Outlook/Hotmail SMTP/IMAP | |
ProtonMail Bridge & direct access | |
SendGrid, Mailgun, Resend, SES | |
MailHog, Mailpit for dev | |
Slack, Discord, Telegram |
39 MCP tools: send, receive, search, delete, mark-read, manage email services, contacts, auto-respond, workflows, mail lab
Web dashboard: full React SPA at localhost:10812
AI assistant: natural language email commands (Ollama, OpenAI, Anthropic, Google)
AI Improve: rewrite email body with style/length/mood controls
AI Assist: describe a service in plain language, LLM fills the config form
Auto-Respond: rule-based + AI-powered auto-reply with spam detection and spoof mode
Bulk Send: paste email lists with rate limiting and anti-spam safeguards
Dual transport: stdio (Claude Desktop) + HTTP streamable (web)
Draft management: save/compose/send from the webapp
Toast notifications: live feedback for all actions
Prompt injection defense: two-layer sanitization (Unicode stripping + safety boundary wrapping)
Mail Lab: throwaway SMTP server for testing with AI-generated messages
Mail Watcher: background IMAP polling with webhook notifications for robofang/fleet-agent integration
Contact import: CSV, vCard, Google People API, Microsoft Graph API + curated lists (US Congress, EU, Austria)
Creative Workflows: 7 AI letter presets with ASCII art and SVG card output
Folder management: create, rename, delete IMAP folders from the webapp
Quick Setup: one-click Gmail/Outlook/Yahoo/iCloud/ProtonMail/Zoho/GMX/Fastmail with email+password
Page | Route | Purpose |
Dashboard |
| KPI cards, recent activity, service health |
Inbox |
| Read, filter, delete, auto-refresh |
Email Detail |
| Full email with HTML body, reply/delete |
Compose |
| Send with drafts, HTML toggle, AI Improve, AI subject, Expander, Bulk Send |
Search |
| Full-text IMAP search |
AI Chat |
| Natural language email assistant with creative workflows |
Mail Lab |
| Throwaway SMTP server, AI message generator, mail watcher |
Contacts |
| Import CSV/vCard/Google/Office 365, search, groups, curated lists |
Auto-Reply |
| Rule-based + AI auto-reply, spam detection, spoof mode, pending approval |
Services |
| Form-based add/remove/test with AI Assist presets |
Tools |
| Execute MCP tools from the browser |
Settings |
| AI provider config, email credentials |
Help |
| Tabbed documentation (6 tabs) |
Tool | Description |
| Send via any service |
| Read IMAP inbox |
| Get full email with body |
| IMAP full-text search |
| Remove email (IMAP) |
| Toggle read status |
| Test connectivity |
| List configured services |
| Manage services |
| One-click Gmail/Outlook/Yahoo/iCloud |
| IMAP folder CRUD |
| Usage help and documentation |
| List newsletter presets |
| Fetch from a preset |
| AI subject line (sampling) |
| Multi-step email plan |
| Contact management |
| Background IMAP polling |
| Creative email generation |
| Auto-respond rules |
| Pending reply management |
Service | Port |
Web dashboard frontend | 10812 |
Backend API + MCP HTTP | 10813 |
A standalone Windows desktop app is available, bundling the webapp + Python backend into a single installer (~15 MB).
# Build everything in one command:
just build-native
# Installer lands at:
# native/target/release/bundle/nsis/Email MCP_0.1.0_x64-setup.exeRequires Rust, Node.js 20+, and Visual Studio Build Tools (for C++ compilation). The backend is compiled via PyInstaller and bundled as a Tauri sidecar -- no Python runtime needed.
# Install all dependencies
uv sync --extra test --extra dev
# Start the web dashboard
.\start.ps1
# Run all backend tests
.venv\Scripts\pytest.exe tests -q
# Run Playwright e2e tests
cd webapp && npx playwright test && cd ..
# Full test suite
.venv\Scripts\pytest.exe tests -q && cd webapp && npx playwright test && cd ..
# Build MCPB package
uv run python build_mcpb.py
# Lint
uv run ruff check srcSee docs/quickstart.md for full setup guide.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.
Hosted email MCP for AI agents with inboxes, send/receive, memory, recovery, and credits.
Shipmail MCP server for AI agent custom-domain email inboxes with REST API and webhooks.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/email-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server