Claude MarketplacesSubmit
sethbang avatar

Proton Mail (unofficial)

sethbang/proton-mail-mcp

This connects AI assistants to Proton Mail through standard SMTP and IMAP protocols via Proton Mail Bridge. It exposes the full email lifecycle: send with threading headers, reply and forward with Markdown rendering, search by sender/subject/date/attachment, bulk operations for moving and flagging messages, folder and label management, and thread-level actions that walk conversations across folders. All destructive operations support dry-run preview, and the send tools verify the Sent-copy UID with retry logic to work around Proton's indexing lag. Reach for this when you want programmatic Proton Mail access without touching private APIs. It sanitizes HTML by default and includes guards against display-name spoofing in the From field.

GitHub stars
2
tools
5
auth
Secret needed
transport
STDIO
env vars
15
last updated
May 30, 2026
View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

send_emailSend an email using Proton Mail SMTP.

Send an email using Proton Mail SMTP.

No parameter schema in public metadata yet.

reply_emailReply to a message with proper threading headers (In-Reply-To, References). Includes the quoted original message with attribution by default.

Reply to a message with proper threading headers (In-Reply-To, References). Includes the quoted original message with attribution by default.

No parameter schema in public metadata yet.

reply_all_emailReply to all original recipients (sender + TO + CC), excluding the authenticated user. Same threading + quoting semantics as `reply_email`.

Reply to all original recipients (sender + TO + CC), excluding the authenticated user. Same threading + quoting semantics as `reply_email`.

No parameter schema in public metadata yet.

forward_emailForward a message to new recipients. Original attachments are carried forward by default.

Forward a message to new recipients. Original attachments are carried forward by default.

No parameter schema in public metadata yet.

save_draftSave an email as a draft without sending it. The draft is placed in the user's `\Drafts` special-use folder.

Save an email as a draft without sending it. The draft is placed in the user's `\Drafts` special-use folder.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

PROTONMAIL_USERNAME*

Your Proton Mail email address

PROTONMAIL_PASSWORD*secret

Your Proton Mail SMTP password (not your login password; generate one in Proton settings)

PROTONMAIL_HOSTdefault: smtp.protonmail.ch

SMTP host

PROTONMAIL_PORTdefault: 587

SMTP port

PROTONMAIL_SECUREdefault: false

Use TLS for SMTP (true for port 465)

IMAP_HOSTdefault: 127.0.0.1

Proton Mail Bridge IMAP host (required for read/search tools)

IMAP_PORTdefault: 1143

Proton Mail Bridge IMAP port

IMAP_SECUREdefault: false

Use TLS for IMAP

IMAP_USERNAME

Proton Mail Bridge username (falls back to PROTONMAIL_USERNAME)

IMAP_PASSWORDsecret

Proton Mail Bridge password (falls back to PROTONMAIL_PASSWORD)

READONLYdefault: false

Disable all mutating tools (send, move, delete, flags, labels, bulk ops, folder/label management)

RESTRICT_OUTBOUND_TO_SELFdefault: false

Refuse live sends to any recipient other than PROTONMAIL_USERNAME (for throwaway/QA accounts)

ALLOW_FILE_DOWNLOAD_DIR

Allowlist directory enabling download_attachment.saveTo; when unset, attachments return as inline base64

ALLOW_EMPTY_FOLDERdefault: false

Register the empty_folder tool (not recommended)

DEBUGdefault: false

Enable verbose logging to stderr

Readme

Proton Mail MCP Server

npm version License: MIT Glama score

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.

⚠️ Unofficial — not affiliated with Proton. This is an independent, community-built project. It is not developed, endorsed, sponsored, or supported by Proton AG. "Proton", "Proton Mail", and "Proton Mail Bridge" are trademarks of Proton AG, used here only to describe interoperability. It talks to Proton Mail over the standard SMTP submission endpoint and the locally-run Proton Mail Bridge; no Proton private API is used. Use at your own risk.

Demo

Proton Mail MCP demo — triaging an inbox from an MCP client

Features

View the full README on GitHub

Details

Repository
github.com/sethbang/proton-mail-mcp
Website
sethbang.github.io/proton-mail-mcp
Categories
Communication & Messaging, Search & Web Crawling
Package
proton-mail-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from sethbang

Related Communication & Messaging MCP servers

View all
1sumioshi avatarWACrewsumioshi/wacrewWhatsApp for AI agents: read chats, transcribe voice notes and reply at a human pace.2stars
2anomalyarmor avatarAnomalyArmoranomalyarmor/agentsData observability tools for engineering teams: alerts, freshness, schema drift, lineage, quality.0stars
3agentsimdev avatarMcpagentsimdev/agentsim-mcpControl plane for agent auth walls. Connector 0 handles SMS OTP with US test numbers.1stars
4henry-ships avatarSparkForge — 20+ Utility APIs with x402 Micropaymentshenry-ships/sparkforge20+ pay-per-use APIs: image gen, crypto data, email verify, SSL check, web scraping, and more.1stars
5loicfontaine-max avatarQoramiloicfontaine-max/qorami-sdkCheck an email before an AI agent sends it: send / ask a human / block. Detects prompt injection.0stars
6mukundakatta avatarAgentfitmukundakatta/agentfit-mcpToken-aware message truncation: fit a chat history into your model's context budget.1stars