mcp-email-server

@ai-zerolab

About mcp-email-server

IMAP and SMTP via MCP Server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-email-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ai-zerolab/mcp-email-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-email-server?

An MCP server that provides IMAP and SMTP capabilities, enabling AI agents to read, send, and manage emails over the Model Context Protocol. Designed for developers integrating email workflows into MCP clients like Claude Desktop.

How to use mcp-email-server?

Install via uvx mcp-email-server@latest stdio or pip install mcp-email-server. Configure using the interactive UI command mcp-email-server ui (writes a TOML file) or by setting environment variables (e.g., MCP_EMAIL_SERVER_EMAIL_ADDRESS, MCP_EMAIL_SERVER_PASSWORD, MCP_EMAIL_SERVER_IMAP_HOST). The server can run in read-only mode if SMTP host is omitted.

Key features of mcp-email-server

IMAP mailbox listing, read, and search operations
SMTP email sending with optional save to Sent folder
Read-only mode when SMTP configuration is omitted
Attachment download (disabled by default for security)
Recipient and sender allowlists for access control
HTTP transport support with DNS rebinding protection

Use cases of mcp-email-server

Automate email workflows through AI assistants
Monitor specific IMAP mailboxes read‑only
Send notifications or replies from agents
Restrict email actions to trusted domains and addresses

FAQ from mcp-email-server

How do I configure mcp-email-server?

Use the interactive UI (mcp-email-server ui) or set environment variables prefixed with MCP_EMAIL_SERVER_. Environment variables take precedence over the TOML configuration file.

Can I run it in read‑only mode?

Yes. Omit the MCP_EMAIL_SERVER_SMTP_HOST variable or SMTP block in the config to enable read‑only mode. Outbound compose tools are hidden when every configured account is read‑only.

How do I enable attachment downloads?

By default attachment download is disabled. Set MCP_EMAIL_SERVER_ENABLE_ATTACHMENT_DOWNLOAD=true as an environment variable or enable_attachment_download = true in the TOML file.

How do I restrict who can send or receive email?

Use MCP_EMAIL_SERVER_ALLOWED_RECIPIENTS to limit send destinations and MCP_EMAIL_SERVER_ALLOWED_SENDERS (supports glob patterns) to filter inbound mail. Empty allowlists permit all.

What transport modes are supported?

The server supports stdio for standard MCP clients and streamable-http (HTTP) for web‑based integrations. HTTP mode validates Host and Origin headers to prevent DNS rebinding attacks.

Frequently asked questions

How do I configure mcp-email-server?

Use the interactive UI (`mcp-email-server ui`) or set environment variables prefixed with `MCP_EMAIL_SERVER_`. Environment variables take precedence over the TOML configuration file.

Can I run it in read‑only mode?

Yes. Omit the `MCP_EMAIL_SERVER_SMTP_HOST` variable or SMTP block in the config to enable read‑only mode. Outbound compose tools are hidden when every configured account is read‑only.

How do I enable attachment downloads?

By default attachment download is disabled. Set `MCP_EMAIL_SERVER_ENABLE_ATTACHMENT_DOWNLOAD=true` as an environment variable or `enable_attachment_download = true` in the TOML file.

How do I restrict who can send or receive email?

Use `MCP_EMAIL_SERVER_ALLOWED_RECIPIENTS` to limit send destinations and `MCP_EMAIL_SERVER_ALLOWED_SENDERS` (supports glob patterns) to filter inbound mail. Empty allowlists permit all.

What transport modes are supported?

The server supports `stdio` for standard MCP clients and `streamable-http` (HTTP) for web‑based integrations. HTTP mode validates Host and Origin headers to prevent DNS rebinding attacks.

Comments

Basic information

More Communication MCP servers

MCP Headless Gmail Server

baryhuang

A MCP (Model Context Protocol) server that provides get, send Gmails without local credential or token setup.

Telegram MCP Server

chigwell

Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.

1.3K

Discord Mcp

SaseQ

A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.

387

AgentCouch

Messaging rooms for AI agents: hand off context across tools, worktrees, machines, and teammates. Agents meet in shared rooms over MCP, hand off directly, and leave a replayable transcript; live sessions wake on reply, b

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au