mcp-email-server

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

Quick start

1. Configure an email account

Run the configuration UI with uv:

uvx mcp-email-server@latest ui

Add your IMAP account in the browser window. SMTP is optional if the account does not need to send email.

2. Configure the MCP client

Add the following server definition to the MCP client:

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

Restart the MCP client after updating its configuration.

3. Verify the connection

Ask the client to list the configured email accounts or recent messages.

Other configuration methods

For headless environments, containers, multiple accounts, custom TLS settings, and environment-variable configuration, see the documentation.

Documentation

• Getting Started
• Configuration
• MCP Tools
• Transports
• Security
• Troubleshooting

Development

See CONTRIBUTING.md.

License

This project is licensed under the terms of the LICENSE.