MiniMail Server

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 -- 188 tests passing, 42 MCP tools, FastMCP 3.4+, dual transport (stdio + HTTP).

Quick Start

.\start.ps1

Opens 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.

Supported Email Systems

Documentation

Features

• 42 MCP tools: send, receive, search, delete, move, copy, forward, mark-read, folder CRUD, manage email services, contacts, auto-respond, workflows, mail lab, fleet connectors
• Web dashboard: full React SPA at localhost:10812
• Microsoft Graph support: send/receive for personal Outlook/Hotmail via Graph REST API (OAuth device flow, public client ID — no Azure registration)
• Folder treeview: expandable sidebar with unread badges + inline folder CRUD
• 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

Web Dashboard

Tools

Ports

Native Desktop App (Tauri 2.0)

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.exe

Requires 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.

Development

# 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 src

See docs/quickstart.md for full setup guide.

License

MIT