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

Type	Providers	Guide
Microsoft Graph	Personal Outlook/Hotmail (basic SMTP/IMAP auth disabled)	docs/outlook.md
SMTP/IMAP	Gmail, Outlook/M365, Yahoo, iCloud, ProtonMail	docs/gmail.md, docs/outlook.md, docs/protonmail.md
Transactional APIs	SendGrid, Mailgun, Resend, Amazon SES	docs/api-services.md
Local Testing	MailHog, Mailpit, MailCatcher, Inbucket	docs/local-testing.md
Webhooks	Slack, Discord, Telegram	docs/webhook-integrations.md

Documentation

Document	Contents
docs/quickstart.md	Installation, Claude Desktop setup, first email
docs/configuration.md	All env vars, mailing lists, dynamic config
docs/TOOLS.md	Full 39-tool reference with REST surface
docs/DEVELOPMENT.md	Architecture, commands, contribution patterns
docs/TROUBLESHOOTING.md	Symptom lookup, diagnostics endpoints
docs/safety-hardening.md	Prompt injection defense architecture
docs/mail-watcher.md	Background IMAP polling + webhook notifications
docs/robofang-integration.md	Integrate with robofang for TTS/light alerts
docs/gmail.md	Gmail app password setup
docs/outlook.md	Outlook/Hotmail — Graph API (OAuth) + SMTP/IMAP
docs/connectors.md	aiwatcher + robofang fleet event connectors
docs/protonmail.md	ProtonMail Bridge & direct access
docs/api-services.md	SendGrid, Mailgun, Resend, SES
docs/local-testing.md	MailHog, Mailpit for dev
docs/webhook-integrations.md	Slack, Discord, Telegram

Features