Proton Mail (unofficial) MCP Server

A Model Context Protocol (MCP) server that gives AI assistants full access to your Proton Mail account -- send, read, search, and organize email over SMTP and IMAP. Its 26 documented tools cover message, email, folder, reply. It runs locally over stdio via the published package.

People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-24 · ★ 3 · #27 OF 75 MAINTAINED EMAIL · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Proton Mail (unofficial)

before you install - you'll need

Set PROTONMAIL_USERNAME, PROTONMAIL_PASSWORD before connecting. ALLOW_FILE_DOWNLOAD_DIR is optional or environment-specific per the README.

Claude Code

claude mcp add sethbang-proton-mail-mcp -- npx -y proton-mail-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "sethbang-proton-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "proton-mail-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 MIT - declared in the repository

npm package proton-mail-mcp - unscoped; check the name against the project README before installing

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

03 · What Proton Mail (unofficial) 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 send an email using Proton Mail SMTP, save an email as a draft without sending it. The draft is placed in the user's \Drafts special-use folder (resolved at runtime, list recent messages from a folder. Supports UID-based pagination, and read a specific message by UID. Returns full headers, body, and attachment metadata. Prefers plain text.

Capability map

Tools grouped from the project's README - what Proton Mail (unofficial) lets an agent do.

Message

5 tools - e.g. Read a specific message by UID. Returns full headers, body, and attachment metadata. Prefers plain text; strips HTML tags from HTML-only messages. Body-part sel; Move a message to a different folder.…

read_message · move_message · delete_message · update_message_flags · update_message_labels

Bulk

4 tools - e.g. Move many messages in a single IMAP operation. Accepts either an explicit uids array or match criteria (XOR, not both). Supports dryRun: true to preview which U; Delete many messages in a single IMAP…

bulk_move · bulk_delete · bulk_update_flags · bulk_update_labels

Folder

4 tools - e.g. Create a new mailbox folder. Idempotent - succeeds silently if the folder already exists. Restricted to the Folders/ namespace (e.g. Folders/Receipts); root-lev; Rename an existing folder or label.…

create_folder · rename_folder · delete_folder · empty_folder

read & search

3 tools - e.g. List all mailbox folders with message and unread counts. No parameters. Counts come from a cached IMAP STATUS that Proton Bridge can serve stale - for an exact ; List attachment metadata (part numbers…

list_folders · list_attachments · get_thread

2 tools - e.g. Reply to a message with proper threading headers (In-Reply-To, References). Includes the quoted original message with attribution by default.; Reply to all original recipients (sender + TO + CC)…

reply_email · reply_all_email

Messages

2 tools - e.g. List recent messages from a folder. Supports UID-based pagination.; Search messages by various criteria. Date filters use IMAP semantics: since is inclusive, before is exclusive.

list_messages · search_messages

run & execute

1 tool - e.g. Send an email using Proton Mail SMTP.

send_email

Forward

1 tool - e.g. Forward a message to new recipients. Original attachments are carried forward by default. Unlike reply, a forward does not set In-Reply-To/References - it start

forward_email

Latest releases

v1.0.2 · 2026-05-30

Patch release focused on MCP tool-description quality and a real annotation fix. No breaking changes. · Fixes · download_attachment annotation corrected. It was annotated readOnlyHint: true but writes to disk when…

v1.0.0 · 2026-05-30

First stable release of proton-mail-mcp - an MCP server for Proton Mail that lets any AI client send, read, search, and organize email over SMTP and IMAP (via Proton Mail Bridge). · Highlights · Sending & safety · HTML…

04 · Who maintains Proton Mail (unofficial)

Proton Mail (unofficial) is maintained by sethbang. We track 2 MCP servers from sethbang - 2 actively maintained, 32 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from sethbang.

Universal Screenshot MCP MCP server for web page and cross-platform system screenshots (macOS, Linux, Windows) ★ 29

05 · Facts

repository: github.com/sethbang/proton-mail-mcp
website: https://sethbang.github.io/proton-mail-mcp/
category: email - ranked #27 of 75 actively-maintained email servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-05-30)
registry: io.github.sethbang/proton-mail-mcp (active, first published 2026-05-30 · 2 versions)
packages: npm:proton-mail-mcp

06 · Proton Mail (unofficial) FAQ

Is Proton Mail (unofficial) still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-24 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Proton Mail (unofficial) do?

How do I install Proton Mail (unofficial)?

Run `npx -y proton-mail-mcp`. The README documents 3 environment variables (PROTONMAIL_USERNAME, PROTONMAIL_PASSWORD, ALLOW_FILE_DOWNLOAD_DIR) to set first. Set PROTONMAIL_USERNAME, PROTONMAIL_PASSWORD before connecting. ALLOW_FILE_DOWNLOAD_DIR is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Proton Mail (unofficial) 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 Proton Mail (unofficial)

Alternatives to Proton Mail (unofficial)

Maintained email servers if Proton Mail (unofficial) isn't the fit.

More email MCP servers · XCRS Mobile & TV Automation · CV Forge · Tickstem MCP Server · Tomba MCP Server · Agent Email

More TypeScript MCP servers · Sevalla · S Gw · Awesome Agent Skills · Psyche AI · Seekstone · see all