📌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: https://github.com/ai-zerolab/mcp-email-server/
• Documentation: https://ai-zerolab.github.io/mcp-email-server/

Installation

Manual Installation

It is recommended to use uv to manage your environment.

Run the following command to configure:

uvx mcp-email-server@latest ui

Use the following configuration for the MCP client:

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

You can also install the package from PyPI:

pip install mcp-email-server

After installation, configure your email server using the UI:

mcp-email-server ui

To use it in Claude Desktop, download from https://claude.ai/download. To integrate with other MCP clients, find the path of the executable with:

which mcp-email-server

Then configure your client like:

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

If Docker is available, you can run the server using the Docker image. Configure your client with:

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

The default configuration path is ~/.config/zerolib/mcp_email_server/config.toml.

Installing via Smithery

To install Email Server for Claude Desktop automatically via Smithery, run:

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

Development

This project is managed using uv.

To set up the development environment and pre-commit hooks, run:

make install

For local development, run:

uv run mcp-email-server

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.
• Create a new tag in the form *.*.*.

For more details, see https://fpgmaas.github.io/cookiecutter-uv/features/cicd/#how-to-trigger-a-release.