← Back to directory
M

MCP Email Server

Community
A multi-account MCP server for reading, searching, organizing, and sending email via IMAP and SMTP
GitHub source repository ↗
★ 316 Stars Category · Other Very popular Source revision fe4b6c8647e3
60FMRS · C
Reliability
8/20
Security and permissions
11/20
Maintenance
15/20
Documentation
14/20
Setup experience
12/20

A fairly complete, cross-platform multi-account email MCP server with a guided setup UI, though the source material does not enumerate specific tool names, and local credential storage plus email-sending capability warrant careful risk review.

Read the FMRS scoring method →

mcp-email-server is an open-source Model Context Protocol server that lets MCP clients read, search, organize, and send email over IMAP and SMTP, with support for multiple accounts across Windows, macOS, and Linux. It ships a configuration UI (mcp-email-server ui) for setting up email accounts and can be run over stdio via uv/uvx for MCP client integration. Version 1.0.0 introduces 'Local Email App V2', which stores credentials in a managed SQLite database and offers a preview-first CLI migration path from legacy TOML/keyring configuration; unmigrated legacy settings continue to work in a backward-compatible mode without forced migration.

Tools

The tool list has not been reviewed yet.

Setup

1) From a source checkout, run uv sync then uv run mcp-email-server ui (or uvx mcp-email-server@latest ui for a published V2 release) to open the configuration UI and add an email account with its address and password — common connection settings are auto-filled from the domain and remain editable; 2) optionally use 'Password & test' to verify the saved account; 3) add a server entry like {"mcpServers": {"mcp-email-server": {"command": "uvx", "args": ["mcp-email-server@latest", "stdio"]}}} to the MCP client configuration; 4) restart the MCP client to apply the settings; 5) ask the client to list configured accounts or recent messages to verify the connection.

claude_desktop_config.json
{"mcpServers": {"mcp-email-server": {"command": "uvx", "args": ["mcp-email-server@latest", "stdio"]}}}

Fit and risk

Best for

  • Individuals or teams who want to read/search/organize/send email directly from an MCP client
  • Users with multiple IMAP/SMTP accounts who want unified management
  • Users comfortable with uv/uvx and local credential setup who can configure their own mail accounts

Not for

  • Users unwilling to store email passwords/credentials locally
  • Setups requiring OAuth (e.g., modern Gmail/Outlook auth) rather than username/password login, which the source material does not confirm is supported
  • Users wanting a fully cloud-hosted email service with no local configuration

Required permissions

  • Stores and uses email account credentials (username/password) in local keyring or managed SQLite storage
  • Reads and searches mailbox content via IMAP
  • Sends email on the user's behalf via SMTP
  • Local filesystem access to read/write configuration (TOML file or SQLite database)

Risks and side effects

  • Email credentials are stored locally (legacy TOML/keyring, or managed SQLite in V2); exposure of this storage could allow unauthorized mailbox access
  • Granting an AI client the ability to send email creates risk of unintended or malicious sends via prompt misuse
  • Migrating from legacy configuration to V2 involves credential import, which can hit conflicts or missing-credential issues if done incorrectly

Troubleshooting

  1. Configuration changes not taking effect: confirm the MCP client was restarted
  2. Legacy import reports a conflict or missing credential: consult the documentation's import troubleshooting section and run `config doctor` to check status
  3. Ensure you're using a release that explicitly documents Local Email App V2 support
  4. When testing from a source checkout, invoke `uv run --directory /path/to/mcp-email-server mcp-email-server stdio` rather than pairing a managed catalog with PyPI `@latest`

Use cases

Letting an AI assistant search and organize inbox messages on your behalf
Drafting and sending email through natural-language instructions
Managing email operations across multiple accounts from one interface

Supported clients

Supported clients have not been confirmed yet.