Which integrations are available for this server?

Provides a comprehensive suite of tools for the Proton privacy ecosystem, enabling AI agents to manage emails, password vaults, cloud storage in Proton Drive, calendar events, and VPN connection status. Integrates with Proton Mail via the Proton Mail Bridge to provide capabilities for listing, searching, reading, sending, and organizing emails, as well as managing attachments and conversation threads. Includes a dedicated tool to check the current connection status of Proton VPN.

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-cli — Proton Pass CLI for password manager tools
Node.js 22+

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Proton-MCP