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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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 Teams Server

InditexTech

An MCP (Model Context Protocol) server implementation for Microsoft Teams integration, providing capabilities to read messages, create messages, reply to messages, mention members.

383

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

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

Telegram MCP server

chaindead

Telegram MCP for managing dialogs, messages, drafts, read statuses, and more.

334