home / mcp / email mcp server

Email MCP Server

Provides IMAP/SMTP access with MCP-based management and optional attachment download.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ai-zerolab-mcp-email-server": {
      "command": "uvx",
      "args": [
        "mcp-email-server@latest",
        "stdio"
      ],
      "env": {
        "MCP_EMAIL_SERVER_IMAP_SSL": "true",
        "MCP_EMAIL_SERVER_PASSWORD": "YOUR_PASSWORD",
        "MCP_EMAIL_SERVER_SMTP_SSL": "true",
        "MCP_EMAIL_SERVER_FULL_NAME": "Email prefix",
        "MCP_EMAIL_SERVER_IMAP_HOST": "imap.example.com",
        "MCP_EMAIL_SERVER_IMAP_PORT": "993",
        "MCP_EMAIL_SERVER_SMTP_HOST": "smtp.example.com",
        "MCP_EMAIL_SERVER_SMTP_PORT": "465",
        "MCP_EMAIL_SERVER_USER_NAME": "[email protected]",
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "default",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "[email protected]",
        "MCP_EMAIL_SERVER_SMTP_START_SSL": "false",
        "MCP_EMAIL_SERVER_ENABLE_ATTACHMENT_DOWNLOAD": "false"
      }
    }
  }
}

You will run an MCP server that provides IMAP and SMTP access through a centralized MCP interface. This lets you manage email accounts and securely access mail via a programmable MCP endpoint, with optional attachment download and UI-based configuration.

How to use

Connect your MCP client to the zerolib-email MCP server to begin managing an email account through the IMAP and SMTP interfaces. You can configure the server to run locally or remotely, and you have options to enable secure connections, manage per-account credentials, and download attachments when needed. Use the UI to configure accounts and the host/port settings, or run the server as a service in your environment and reference the MCP configuration in your client.

How to install

Prerequisites: you should have Python and a Node tooling path available, plus a command runner for your chosen environment (see options below). The server is published to PyPI and can be installed with Python, or run via a Node-based MCP runner. Choose one of the deployment paths and follow the steps.

# Option A: Install and run via Python package (PyPI)
pip install mcp-email-server

# Start UI to configure the server (opens a local UI)
mcp-email-server ui

# Option B: Run via uvx MCP runner (recommended for environment management)
uvx mcp-email-server@latest ui

# Example MCP client setup to reference this server

Additional configuration and usage notes

Environment-based configuration is supported. You can place settings in a TOML file or supply them as environment variables. The variables shown below control account details, server hosts, and connection security. Use the environment-variable approach in CI/CD pipelines or when you want to override UI settings.

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

Available tools

download_attachment

Saves email attachments to a specified path after enabling the feature.