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

emailemail-serverfastmcpimapmcpmcp-servermodel-context-protocolmulti-accountpythonsmtp
View on GitHub ↗
Stars
299★
Forks
114
Language
Python
License
BSD-3-Clause
Created
2025-02-24
Last push
2026-08-05