📌Overview

Purpose: Provide a robust email server solution supporting both IMAP and SMTP protocols through the MCP framework.

Overview: The mcp-email-server is designed to facilitate efficient email communication by integrating seamlessly with various clients. It combines usability with powerful features that enhance the management of email operations within applications.

Key Features:

IMAP and SMTP Support: Offers full capability to send and receive emails, ensuring reliable communication through standard protocols.
Flexible Configuration: Easily set up via UI or integration with existing MCP clients, allowing for custom configurations tailored to user needs.

mcp-email-server

IMAP and SMTP via MCP Server

GitHub Repository: mcp-email-server
Documentation: Documentation

Installation

Manual Installation

We recommend using uv to manage your environment.

Configure the MCP client:

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

Install using pip:
```
pip install mcp-email-server
```
Configure your email server:
```
mcp-email-server ui
```

To integrate with other MCP clients, use:

{
  "mcpServers": {
    "zerolib-email": {
      "command": "{{ ENTRYPOINT }}",
      "args": ["stdio"]
    }
  }
}

If using Docker:

{
  "mcpServers": {
    "zerolib-email": {
      "command": "docker",
      "args": ["run", "-it", "ghcr.io/ai-zerolab/mcp-email-server:latest"]
    }
  }
}

Installing via Smithery

To install Email Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

Development

This project is managed using uv.

Run make install to set up the virtual environment and pre-commit hooks.
Use uv run mcp-email-server for local development.

Releasing a New Version

Create an API Token on PyPI.
Add the API Token to your project's secrets with the name PYPI_TOKEN.
Create a new release on GitHub.
Tag the release in the format *.*.*.

For more details, see the project's documentation on release procedures.