Email MCP - install, status & alternatives [2026]

01 · Install Email MCP

before you install - you'll need

Set MCP_EMAIL_ADDRESS, MCP_EMAIL_PASSWORD, MCP_EMAIL_IMAP_HOST, MCP_EMAIL_SMTP_HOST before connecting.

Claude Code

claude mcp add codefuturist-email-mcp -- npx -y @codefuturist/email-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codefuturist-email-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@codefuturist/email-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license LGPL-3.0 - declared in the repository

npm package @codefuturist/email-mcp - published under the repo owner's npm scope (@codefuturist)

registry namespace io.github.codefuturist is GitHub-verified and matches the repo owner

03 · What Email MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all configured email accounts, list folders with unread counts and special-use flags, read full email content with attachment metadata, and fetch full content of multiple emails in a single call (max 20).

Capability map

Tools grouped from the project's README - what Email MCP lets an agent do.

Email

11 tools - e.g. Read full email content with attachment metadata; Get read/flag/label state of an email without fetching the body; Discover the real folder(s) an email resides in (resolves virtual folders)

get_email · get_email_status · find_email_folder · get_email_stats · send_email · reply_email…

read & search

8 tools - e.g. List all configured email accounts; List folders with unread counts and special-use flags; Reconstruct a conversation thread via References/In-Reply-To

list_accounts · list_mailboxes · get_thread · list_templates · list_labels · get_watcher_status…

Label

4 tools - e.g. Add a label to an email (ProtonMail folders, Gmail X-GM-LABELS, or IMAP keywords); Remove a label from an email; Create a new label

add_label · remove_label · create_label · delete_label

Emails

3 tools - e.g. Paginated email listing with date, sender, subject, and flag filters; Fetch full content of multiple emails in a single call (max 20); Search by keyword across subject, sender, and body

list_emails · get_emails · search_emails

Mailbox

3 tools - e.g. Create a new mailbox folder; Rename an existing mailbox folder; Permanently delete a mailbox and contents

create_mailbox · rename_mailbox · delete_mailbox

Check

2 tools - e.g. Connection health, latency, quota, and IMAP capabilities; Diagnose desktop notification support and provide setup instructions

check_health · check_notification_setup

Scheduled

2 tools - e.g. List scheduled emails by status; Cancel a pending scheduled email

list_scheduled · cancel_scheduled

Download

1 tool - e.g. Download an email attachment by filename

download_attachment

Latest releases

v0.2.1 · 2026-02-20

add Dockerfile, docker-compose, and CI docker build ( <>) · add GoReleaser dockers_v2 for GHCR and Docker Hub publishing ( <>) · add OCI manifest annotations for GHCR multi-arch images ( <>) · add docker and goreleaser…

v0.2.0 · 2026-02-18

04 · Who maintains Email MCP

email-mcp is maintained by codefuturist. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/codefuturist/email-mcp
category: email - ranked #2 of 75 actively-maintained email servers as of 2026-08-25.
registry: io.github.codefuturist/email-mcp (active, first published 2026-02-18 · 4 versions)
packages: npm:@codefuturist/email-mcp

06 · Email MCP FAQ

Is Email MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-21. We re-verify nightly.

What can Email MCP do?

With this server connected, an agent can list all configured email accounts, list folders with unread counts and special-use flags, read full email content with attachment metadata, and fetch full content of multiple emails in a single call (max 20).

How do I install Email MCP?

Run `npx -y @codefuturist/email-mcp`. The README documents 4 environment variables (MCP_EMAIL_ADDRESS, MCP_EMAIL_PASSWORD, MCP_EMAIL_IMAP_HOST…) to set first. Set MCP_EMAIL_ADDRESS, MCP_EMAIL_PASSWORD, MCP_EMAIL_IMAP_HOST, MCP_EMAIL_SMTP_HOST before connecting. You can also paste the ready-made client config above.

Does Email MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Email MCP

Alternatives to Email MCP

Maintained email servers if Email MCP isn't the fit.

head to head · Emailmd vs Email MCP · Google Workspace (aaronsb) vs Email MCP

More email MCP servers · Google Workspace MCP Server · Mail Muncher · Mailbridge · Multi-Account Gmail

More TypeScript MCP servers · Mat · Portkey Admin MCP · Schelling Protocol · Zotero Bridge · CometChat Docs · see all