io.github.sethbang/proton-mail-mcp

npm

Unofficial Proton Mail MCP — send, read, search & organize email over SMTP and IMAP

3 GitHub npm

No known CVEs

No license

Actively maintained

Last commit 5d ago

Works with most clients

Transport: stdio, sse, http

0 tools

Grade F

MCPpedia last refreshed this data 1d ago

Edit this pageView history

Communication

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "protonmail": {
      "env": {
        "PROTONMAIL_PASSWORD": "your-smtp-password",
        "PROTONMAIL_USERNAME": "your-email@protonmail.com"
      },
      "args": [
        "-y",
        "proton-mail-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-sethbang-proton-mail-mcp-sethbang)](https://mcppedia.org/s/io-github-sethbang-proton-mail-mcp-sethbang)

Read me

What io.github.sethbang/proton-mail-mcp does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'npm' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

21/100across 5 weighted dimensions

How we score →

0255075100

−79

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked npm against OSV.dev.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.sethbang/proton-mail-mcp safe to use?: io.github.sethbang/proton-mail-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.sethbang/proton-mail-mcp?: io.github.sethbang/proton-mail-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What AI clients work with io.github.sethbang/proton-mail-mcp?: io.github.sethbang/proton-mail-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.sethbang/proton-mail-mcp actively maintained?: io.github.sethbang/proton-mail-mcp is actively maintained — last commit was 5 days ago. It has 3 GitHub stars.

Similar servers

Others in communication

View all →

Mcp_agent_mail94

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Ms 365 Mcp Server91

A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API

862 22

Server90

PubNub Model Context Protocol MCP Server for Cursor and Claude

32 2

io.github.codefuturist/email-mcp88

IMAP/SMTP email MCP server — 47 tools, IMAP IDLE push, multi-account, AI triage.

77 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.sethbang/proton-mail-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "protonmail": { "env": { "PROTONMAIL_PASSWORD": "your-smtp-password", "PROTONMAIL_USERNAME": "your-email@protonmail.com" }, "args": [ "-y", "proton-mail-mcp" ], "command": "npx" } } }

Proton Mail 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.

⚠️ 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.

Features

Send, reply, and forward email via Proton Mail SMTP with threading headers; dedicated reply_all_email tool

Markdown bodies -- pass markdownBody to send_email / reply_email / reply_all_email / forward_email; rendered to HTML with a plain-text fallback

Read email via IMAP through Proton Mail Bridge

Attachments -- send files (base64), download to memory or to disk (saveTo + ALLOW_FILE_DOWNLOAD_DIR), forward a subset by part number

Search messages by sender, recipient, subject, body, date, flags, size, List-ID, attachment presence, attachment name (substring), and attachment MIME type

Organize -- move, delete, and flag/unflag messages individually or in bulk; bulk-update labels too

Bulk operations -- bulk_move, bulk_delete, bulk_update_flags, bulk_update_labels with dryRun preview and XOR uid/match input

Folder & label management -- create_folder, create_label, rename_folder, delete_folder (non-destructive on Proton); empty_folder (opt-in via ALLOW_EMPTY_FOLDER=true; not recommended)

Labeling -- update_message_labels adds and removes Proton labels on a message (additive — message stays in its source folder)

Aggregations -- count_messages, folder_stats, top_senders (with excludeSelf + per-row direction) for inbox analytics

Thread mutations -- move_thread, delete_thread, flag_thread with optional cross-folder walk; get_thread dedupes by Message-ID across mailbox copies

Snippets -- optional includeSnippet on list_messages and search_messages for at-a-glance previews

List folders with message and unread counts

Honest accounting -- post-STORE FETCH verify on flags/labels surfaces silently-dropped operations as notApplied; sent-copy lookup retries SEARCH to defeat Proton's index lag; Reply-To rewrites are surfaced in the send response

Safety first -- delete moves to Trash by default (via special-use resolver), read-only mode via READONLY=true, dryRun on all bulk ops, MCP tool annotations for client-side confirmation prompts, path-traversal defense on filesystem-touching tools

Security hardened -- input validation, credential sanitization, rate limiting, attachment size limits

Works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.)

Frequently Asked Questions

Is io.github.sethbang/proton-mail-mcp safe to use?

io.github.sethbang/proton-mail-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.sethbang/proton-mail-mcp?

io.github.sethbang/proton-mail-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What AI clients work with io.github.sethbang/proton-mail-mcp?

io.github.sethbang/proton-mail-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.sethbang/proton-mail-mcp actively maintained?

io.github.sethbang/proton-mail-mcp is actively maintained — last commit was 5 days ago. It has 3 GitHub stars.