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

We recommend using uv to manage your environment.

Try uvx mcp-email-server ui to config, and use following configuration for mcp client:

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

To upgrade, use uv tool upgrade mcp-email-server

This package is available on PyPI, so you can install it using pip install mcp-email-server

After that, configure your email server using the ui: mcp-email-server ui

Then you can try it in Claude Desktop. If you want to intergrate it with other mcp client, run $which mcp-email-server for the path and configure it in your client like:

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

If docker is avaliable, you can try use docker image, but you may need to config it in your client using tools via MCP. The default config path is ~/.config/zerolib/mcp_email_server/config.toml

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

Development

This project is managed using uv.

Try make install to install the virtual environment and install the 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 projects secrets with the name PYPI_TOKEN by visiting this page.
Create a new release on Github.
Create a new tag in the form *.*.*.

For more details, see here.