Email MCP 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 — 86 tests passing, 15 MCP tools, FastMCP 3.2+, 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

• 15 MCP tools: send, receive, search, delete, mark-read, manage email services

• 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

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 (69)
.venv\Scripts\pytest.exe tests -q

# Run Playwright e2e tests (17)
cd webapp && npx playwright test && cd ..

# Full test suite: 86 tests
.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