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

We recommend using uv to manage your environment.

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

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

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

Environment Variable Configuration

You can also configure the email server using environment variables, which is particularly useful for CI/CD environments like Jenkins. zerolib-email supports both UI configuration (via TOML file) and environment variables, with environment variables taking precedence.

{
  "mcpServers": {
    "zerolib-email": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "work",
        "MCP_EMAIL_SERVER_FULL_NAME": "John Doe",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "john@example.com",
        "MCP_EMAIL_SERVER_USER_NAME": "john@example.com",
        "MCP_EMAIL_SERVER_PASSWORD": "your_password",
        "MCP_EMAIL_SERVER_IMAP_HOST": "imap.gmail.com",
        "MCP_EMAIL_SERVER_IMAP_PORT": "993",
        "MCP_EMAIL_SERVER_SMTP_HOST": "smtp.gmail.com",
        "MCP_EMAIL_SERVER_SMTP_PORT": "465"
      }
    }
  }
}

Available Environment Variables

| Variable | Description | Default | Required | | --------------------------------------------- | ------------------------------------------------------ | ------------- | -------- | | MCP_EMAIL_SERVER_ACCOUNT_NAME | Account identifier | "default" | No | | MCP_EMAIL_SERVER_FULL_NAME | Display name | Email prefix | No | | MCP_EMAIL_SERVER_EMAIL_ADDRESS | Email address | - | Yes | | MCP_EMAIL_SERVER_USER_NAME | Login username | Same as email | No | | MCP_EMAIL_SERVER_PASSWORD | Email password | - | Yes | | MCP_EMAIL_SERVER_IMAP_HOST | IMAP server host | - | Yes | | MCP_EMAIL_SERVER_IMAP_PORT | IMAP server port | 993 | No | | MCP_EMAIL_SERVER_IMAP_SSL | Enable IMAP SSL

... View full README on GitHub