Happy slice of mcp pizzaMCP.pizza

mcp-email-server

MCP.Pizza Chef: Wh1isper

It works with ordinary mail accounts — a work address, Gmail, Outlook, Fastmail, anything using standard mail settings — and you can connect more than one at a time. Setup runs through a small settings screen in your browser: type in the address and password, and it fills in the connection details from your email domain, keeping the password in your computer's own credential store. Windows, macOS, and Linux are all supported, and outgoing mail is optional if you only want reading.

Communication
Email

Use This MCP server To

Find every email from my landlord this year Summarize what arrived while I was on holiday Draft and send a reply without switching apps Search two mailboxes at once for one message Sort newsletters out of the way of real mail

README

mcp-email-server

Release Build status codecov License

An MCP server for reading, searching, organizing, and sending email through IMAP and SMTP.

Note

Version 1.0.0 introduces Local Email App V2. Updating the package does not automatically import existing settings created with PyPI 0.16.0 and earlier: they remain active in backward-compatible legacy mode, so there is no required migration. If you would like to use the new managed storage, you can review and import those settings whenever it is convenient.

mcp-email-server supports Windows, macOS, and Linux. See Security for platform-specific filesystem and credential storage details.

Optional migration for existing installations

An @latest release that includes Local Email App V2 offers a preview-first CLI migration:

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

The apply step displays the plan again and asks for IMPORT confirmation. A complete import selects managed mode; otherwise the existing legacy settings remain selected. The source TOML file and its legacy keyring entries are left untouched. You can also run uvx mcp-email-server@latest ui and choose Import existing settings. After a successful import, restart running MCP clients. See the detailed upgrade guidance and import troubleshooting.

Quick start

mcp-email-server FAQ

Which email providers work?
Anything using standard mail settings, which covers most providers. The setup screen guesses the details from your address and lets you correct them.
Do I need a key of any kind?
No, but you do need your mailbox login. Several providers want an app-specific password rather than your everyday one.
Can I use this to send an email for me?
Yes — sending is supported. You can also leave outgoing mail unconfigured if you would rather it only ever read.
How hard is the setup?
One command opens a settings screen where you add your account, then you paste a short block into your assistant's configuration. No coding involved.
Which apps does it work in?
Any app that supports MCP, using the standard configuration block shown in the instructions.
Can I connect more than one mailbox?
Yes, several accounts are supported, and you can ask the assistant which ones are set up.
Where does my password live?
On your own computer, in its credential store. The project keeps a security page explaining how that differs by operating system.
Is it maintained?
Yes. Version 1.0 with a rebuilt settings app is recent work, and the project had commits within the last few days.