1.6 KiB
2026-02-24 Session Notes
ProtonMail MCP Server Setup
Nicholai initiated setup of the proton-mcp repository (https://github.com/ccunning2/proton-mcp), a Model Context Protocol server that integrates ProtonMail with Claude Desktop through the Proton Bridge application.
Project Overview
The proton-mcp server enables email management (search, send, retrieve, move between folders), pattern-based spam detection with scoring levels (unlikely/low/medium/high), and RFC 2369/8058-compliant unsubscribe operations with bulk mailing list identification. All destructive actions require explicit user confirmation.
Architecture & Dependencies
The project is Python-based and requires three prerequisites: a ProtonMail account (any tier), Proton Bridge running locally on the system, and Claude Desktop installed. Installation follows standard Python venv workflow: clone repository, create virtual environment, install dependencies from requirements.txt.
Configuration Requirements
Setup requires a .env file with two credentials: PROTON_EMAIL (user's Proton address) and PROTON_BRIDGE_PASSWORD (Bridge app authentication token). IMAP and SMTP connections use default localhost ports 1143 and 1025 respectively. Claude Desktop configuration references the Python executable and server script with these connection details.
Tools Available
The server exposes multiple tools including search_emails, send_email, get_email_content, filter_junk_emails, and unsubscribe-related functions. The implementation prioritizes safety by requiring confirmation for operations that modify mailbox state.
Session was in early setup phase when truncated.