MCP Email Server

Name: MCP Email Server
Author: ai-zerolab

ai-zerolab

Get started Repository

Multi-account email server that reads, searches, organizes and sends email via IMAP and SMTP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add email --env MCP_EMAIL_SERVER_ACCOUNT_NAME='<MCP_EMAIL_SERVER_ACCOUNT_NAME>' --env MCP_EMAIL_SERVER_EMAIL_ADDRESS='<MCP_EMAIL_SERVER_EMAIL_ADDRESS>' --env MCP_EMAIL_SERVER_FULL_NAME='<MCP_EMAIL_SERVER_FULL_NAME>' --env MCP_EMAIL_SERVER_IMAP_HOST='<MCP_EMAIL_SERVER_IMAP_HOST>' --env MCP_EMAIL_SERVER_IMAP_PORT='<MCP_EMAIL_SERVER_IMAP_PORT>' --env MCP_EMAIL_SERVER_PASSWORD='<MCP_EMAIL_SERVER_PASSWORD>' --env MCP_EMAIL_SERVER_SMTP_HOST='<MCP_EMAIL_SERVER_SMTP_HOST>' --env MCP_EMAIL_SERVER_SMTP_PORT='<MCP_EMAIL_SERVER_SMTP_PORT>' --env MCP_EMAIL_SERVER_USER_NAME='<MCP_EMAIL_SERVER_USER_NAME>' -- npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

~/.codex/config.toml

[mcp_servers.email]
command = "npx"
args = ["-y", "@smithery/cli", "install", "@ai-zerolab/mcp-email-server", "--client", "claude"]
env = { MCP_EMAIL_SERVER_ACCOUNT_NAME = "<MCP_EMAIL_SERVER_ACCOUNT_NAME>", MCP_EMAIL_SERVER_EMAIL_ADDRESS = "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>", MCP_EMAIL_SERVER_FULL_NAME = "<MCP_EMAIL_SERVER_FULL_NAME>", MCP_EMAIL_SERVER_IMAP_HOST = "<MCP_EMAIL_SERVER_IMAP_HOST>", MCP_EMAIL_SERVER_IMAP_PORT = "<MCP_EMAIL_SERVER_IMAP_PORT>", MCP_EMAIL_SERVER_PASSWORD = "<MCP_EMAIL_SERVER_PASSWORD>", MCP_EMAIL_SERVER_SMTP_HOST = "<MCP_EMAIL_SERVER_SMTP_HOST>", MCP_EMAIL_SERVER_SMTP_PORT = "<MCP_EMAIL_SERVER_SMTP_PORT>", MCP_EMAIL_SERVER_USER_NAME = "<MCP_EMAIL_SERVER_USER_NAME>" }

# codex mcp add email --env MCP_EMAIL_SERVER_ACCOUNT_NAME='<MCP_EMAIL_SERVER_ACCOUNT_NAME>' --env MCP_EMAIL_SERVER_EMAIL_ADDRESS='<MCP_EMAIL_SERVER_EMAIL_ADDRESS>' --env MCP_EMAIL_SERVER_FULL_NAME='<MCP_EMAIL_SERVER_FULL_NAME>' --env MCP_EMAIL_SERVER_IMAP_HOST='<MCP_EMAIL_SERVER_IMAP_HOST>' --env MCP_EMAIL_SERVER_IMAP_PORT='<MCP_EMAIL_SERVER_IMAP_PORT>' --env MCP_EMAIL_SERVER_PASSWORD='<MCP_EMAIL_SERVER_PASSWORD>' --env MCP_EMAIL_SERVER_SMTP_HOST='<MCP_EMAIL_SERVER_SMTP_HOST>' --env MCP_EMAIL_SERVER_SMTP_PORT='<MCP_EMAIL_SERVER_SMTP_PORT>' --env MCP_EMAIL_SERVER_USER_NAME='<MCP_EMAIL_SERVER_USER_NAME>' -- npx -y @smithery/cli install @ai-zerolab/mcp-email-server --client claude

~/.cursor/mcp.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "<MCP_EMAIL_SERVER_ACCOUNT_NAME>",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>",
        "MCP_EMAIL_SERVER_FULL_NAME": "<MCP_EMAIL_SERVER_FULL_NAME>",
        "MCP_EMAIL_SERVER_IMAP_HOST": "<MCP_EMAIL_SERVER_IMAP_HOST>",
        "MCP_EMAIL_SERVER_IMAP_PORT": "<MCP_EMAIL_SERVER_IMAP_PORT>",
        "MCP_EMAIL_SERVER_PASSWORD": "<MCP_EMAIL_SERVER_PASSWORD>",
        "MCP_EMAIL_SERVER_SMTP_HOST": "<MCP_EMAIL_SERVER_SMTP_HOST>",
        "MCP_EMAIL_SERVER_SMTP_PORT": "<MCP_EMAIL_SERVER_SMTP_PORT>",
        "MCP_EMAIL_SERVER_USER_NAME": "<MCP_EMAIL_SERVER_USER_NAME>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "email": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "<MCP_EMAIL_SERVER_ACCOUNT_NAME>",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>",
        "MCP_EMAIL_SERVER_FULL_NAME": "<MCP_EMAIL_SERVER_FULL_NAME>",
        "MCP_EMAIL_SERVER_IMAP_HOST": "<MCP_EMAIL_SERVER_IMAP_HOST>",
        "MCP_EMAIL_SERVER_IMAP_PORT": "<MCP_EMAIL_SERVER_IMAP_PORT>",
        "MCP_EMAIL_SERVER_PASSWORD": "<MCP_EMAIL_SERVER_PASSWORD>",
        "MCP_EMAIL_SERVER_SMTP_HOST": "<MCP_EMAIL_SERVER_SMTP_HOST>",
        "MCP_EMAIL_SERVER_SMTP_PORT": "<MCP_EMAIL_SERVER_SMTP_PORT>",
        "MCP_EMAIL_SERVER_USER_NAME": "<MCP_EMAIL_SERVER_USER_NAME>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "<MCP_EMAIL_SERVER_ACCOUNT_NAME>",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>",
        "MCP_EMAIL_SERVER_FULL_NAME": "<MCP_EMAIL_SERVER_FULL_NAME>",
        "MCP_EMAIL_SERVER_IMAP_HOST": "<MCP_EMAIL_SERVER_IMAP_HOST>",
        "MCP_EMAIL_SERVER_IMAP_PORT": "<MCP_EMAIL_SERVER_IMAP_PORT>",
        "MCP_EMAIL_SERVER_PASSWORD": "<MCP_EMAIL_SERVER_PASSWORD>",
        "MCP_EMAIL_SERVER_SMTP_HOST": "<MCP_EMAIL_SERVER_SMTP_HOST>",
        "MCP_EMAIL_SERVER_SMTP_PORT": "<MCP_EMAIL_SERVER_SMTP_PORT>",
        "MCP_EMAIL_SERVER_USER_NAME": "<MCP_EMAIL_SERVER_USER_NAME>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "<MCP_EMAIL_SERVER_ACCOUNT_NAME>",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>",
        "MCP_EMAIL_SERVER_FULL_NAME": "<MCP_EMAIL_SERVER_FULL_NAME>",
        "MCP_EMAIL_SERVER_IMAP_HOST": "<MCP_EMAIL_SERVER_IMAP_HOST>",
        "MCP_EMAIL_SERVER_IMAP_PORT": "<MCP_EMAIL_SERVER_IMAP_PORT>",
        "MCP_EMAIL_SERVER_PASSWORD": "<MCP_EMAIL_SERVER_PASSWORD>",
        "MCP_EMAIL_SERVER_SMTP_HOST": "<MCP_EMAIL_SERVER_SMTP_HOST>",
        "MCP_EMAIL_SERVER_SMTP_PORT": "<MCP_EMAIL_SERVER_SMTP_PORT>",
        "MCP_EMAIL_SERVER_USER_NAME": "<MCP_EMAIL_SERVER_USER_NAME>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ],
      "env": {
        "MCP_EMAIL_SERVER_ACCOUNT_NAME": "<MCP_EMAIL_SERVER_ACCOUNT_NAME>",
        "MCP_EMAIL_SERVER_EMAIL_ADDRESS": "<MCP_EMAIL_SERVER_EMAIL_ADDRESS>",
        "MCP_EMAIL_SERVER_FULL_NAME": "<MCP_EMAIL_SERVER_FULL_NAME>",
        "MCP_EMAIL_SERVER_IMAP_HOST": "<MCP_EMAIL_SERVER_IMAP_HOST>",
        "MCP_EMAIL_SERVER_IMAP_PORT": "<MCP_EMAIL_SERVER_IMAP_PORT>",
        "MCP_EMAIL_SERVER_PASSWORD": "<MCP_EMAIL_SERVER_PASSWORD>",
        "MCP_EMAIL_SERVER_SMTP_HOST": "<MCP_EMAIL_SERVER_SMTP_HOST>",
        "MCP_EMAIL_SERVER_SMTP_PORT": "<MCP_EMAIL_SERVER_SMTP_PORT>",
        "MCP_EMAIL_SERVER_USER_NAME": "<MCP_EMAIL_SERVER_USER_NAME>"
      }
    }
  }
}

Environment variables

MCP_EMAIL_SERVER_ACCOUNT_NAME
MCP_EMAIL_SERVER_EMAIL_ADDRESS
MCP_EMAIL_SERVER_FULL_NAME
MCP_EMAIL_SERVER_IMAP_HOST
MCP_EMAIL_SERVER_IMAP_PORT
MCP_EMAIL_SERVER_PASSWORD
MCP_EMAIL_SERVER_SMTP_HOST
MCP_EMAIL_SERVER_SMTP_PORT
MCP_EMAIL_SERVER_USER_NAME

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related