Wh1isper/mcp-email-server
Full-featured, multi-account MCP email server for Windows, macOS, and Linux—read, search, organize, and send email via IMAP and SMTP.
299 ★114 forksPythonUpdated 2d ago
What you need to know
MCP server for reading, searching, organizing, and sending email through IMAP and SMTP, with v1.0.0 adding a 'Local Email App V2' browser-based configuration UI backed by managed SQLite storage and OS keyring credentials.
Install
uv sync && uv run mcp-email-server ui (from source checkout)
uvx mcp-email-server@latest (published release)
MCP client config: {"command": "uvx", "args": ["mcp-email-server@latest", "stdio"]}Usage
- •Run `mcp-email-server ui` and keep the foreground command running; the account-first UI takes email address + password and auto-fills connection settings from the domain
- •Add the stdio server definition to your MCP client, then restart the MCP client
- •Verify by asking the client to list the configured email accounts or recent messages
- •Optional migration from PyPI 0.16.0 settings: uvx mcp-email-server@latest config init / config import-legacy / config import-legacy --apply / config doctor
Key features
- ✓Read, search, organize, and send email over IMAP and SMTP
- ✓Local Email App V2: browser-based configuration UI with managed storage (SQLite) and OS keyring credential storage
- ✓Backward-compatible legacy mode — old settings (PyPI 0.16.0 and earlier) keep running without a required migration
- ✓Supports Windows, macOS, and Linux with documented platform-specific filesystem and credential storage details
- ✓Documentation covers headless environments, containers, multiple accounts, custom TLS, env-var config, transports, and troubleshooting
Best for
Giving an LLM assistant managed read/write email capabilities over IMAP/SMTP, with a friendly GUI setup instead of raw config files.
Caveats
- ⚠Updating to 1.0.0 does not auto-import existing settings; legacy mode remains active until you run the optional import
- ⚠Requires uv; the stdio command pairs a managed catalog with the PyPI @latest release
Platforms: Windows · macOS · Linux
Documentation ↗Reviewed 2026-08-07
Topics
- Stars
- 299★
- Forks
- 114
- Language
- Python
- License
- BSD-3-Clause
- Created
- 2025-02-24
- Last push
- 2026-08-05