Skip to main content
Glama

proton-mcp

MCP server for the Proton privacy suite — Mail, Pass, Drive, Calendar, and VPN. 36 tools for Claude and other MCP-compatible AI agents.

Built by Scott Jorgensen and Jorgenclaw (AI agent) for the jorgenclaw.ai sovereignty stack.

Requirements

  • Proton Mail Bridge — running on the host (provides IMAP/SMTP access to Proton Mail)

  • pass-cliProton Pass CLI for password manager tools

  • Node.js 22+

Related MCP server: Proton Drive MCP

Installation

git clone https://github.com/jorgenclaw/proton-mcp.git
cd proton-mcp
npm install

Create a .env file from the example:

cp .env.example .env
# Edit .env with your Proton Bridge credentials

Configuration

PROTON_BRIDGE_HOST=127.0.0.1
PROTON_BRIDGE_IMAP_PORT=1143
PROTON_BRIDGE_SMTP_PORT=1025
PROTON_BRIDGE_USER=your@proton.me
PROTON_BRIDGE_PASS=your-bridge-password
PROTON_BRIDGE_FROM=your@proton.me

The Bridge password is found in Proton Bridge → Settings → your account → IMAP/SMTP password (this is NOT your Proton account password).

Usage

With Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "proton": {
      "command": "node",
      "args": ["/path/to/proton-mcp/index.js"],
      "env": {
        "PROTON_BRIDGE_HOST": "127.0.0.1",
        "PROTON_BRIDGE_IMAP_PORT": "1143",
        "PROTON_BRIDGE_SMTP_PORT": "1025",
        "PROTON_BRIDGE_USER": "your@proton.me",
        "PROTON_BRIDGE_PASS": "your-bridge-password",
        "PROTON_BRIDGE_FROM": "your@proton.me"
      }
    }
  }
}

With NanoClaw

Mount as an MCP server in the container configuration. See the NanoClaw docs for MCP server setup.

Standalone

node --env-file=.env index.js

The server communicates via MCP stdio protocol.

Tools (36)

Mail (16 tools)

Tool

Description

mail__get_unread

Get unread message count and summaries

mail__list_messages

List recent messages from inbox

mail__get_message

Get full message content by ID

mail__search_messages

Search across INBOX, Sent, Drafts, Archive

mail__get_thread

Get all messages in a thread

mail__send_message

Send a new email

mail__reply_message

Reply to a message (preserves threading)

mail__forward_message

Forward a message to another recipient

mail__mark_message

Mark as read/unread

mail__star_message

Star/unstar a message

mail__delete_message

Permanently delete a message

mail__move_message

Move to a different folder

mail__list_folders

List all mail folders

mail__list_folder_messages

List messages in a specific folder

mail__get_attachments

Download message attachments

mail__get_thread

Reconstruct full conversation thread

Pass (9 tools)

Tool

Description

pass__list_vaults

List available Proton Pass vaults

pass__list_items

List items in a vault (no passwords shown)

pass__search_items

Search items by keyword (no passwords shown)

pass__get_item

Get full credential (username, password, URLs)

pass__create_item

Store a new login credential

pass__update_item

Update an existing credential

pass__trash_item

Move an item to trash

pass__get_totp

Generate current TOTP code for 2FA

pass__generate_password

Generate a secure random password

Drive (6 tools)

Tool

Description

drive__list

List files and folders

drive__download

Download a file

drive__upload

Upload a file

drive__upload_folder

Upload an entire folder

drive__mkdir

Create a directory

drive__delete

Delete a file or folder

Calendar (5 tools)

Tool

Description

calendar__list_events

List upcoming events

calendar__get_event

Get event details

calendar__create_event

Create a new event

calendar__update_event

Update an existing event

calendar__delete_event

Delete an event

VPN (1 tool)

Tool

Description

vpn__status

Check Proton VPN connection status

Security Notes

  • Proton Bridge password is NOT your Proton account password — it's a Bridge-specific IMAP/SMTP password

  • pass__list_items and pass__search_items never expose passwords or TOTP seeds

  • Only pass__get_item returns the actual password — use it deliberately

  • The .env file contains credentials — keep it out of version control

License

MIT — see LICENSE

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to send, read, search, and organize emails via ProtonMail using Proton Bridge. Supports MCP-compatible clients like Claude and Cursor.
    Last updated
    17
    27
    3
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server for Proton Pass. It wraps the official pass-cli binary and exposes 14 tools so any MCP-compatible AI assistant (Claude Desktop, Claude Code, etc.) can manage your vaults, credentials, and secrets.
    Last updated

View all related MCP servers

Related MCP Connectors

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.

  • Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jorgenclaw/proton-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server