.agents/memory/2026-02-24-proton-mcp-server-setup-2.md

1.3 KiB

2026-02-24 Session Notes

Proton MCP Server Setup

Session initiated setup of ccunning2/proton-mcp, a Python-based Model Context Protocol server that integrates ProtonMail with Claude Desktop. The assistant researched the project requirements and began the installation process.

Project Overview

Proton MCP provides email management (search, send, move, retrieve), junk detection with pattern-based spam scoring, and RFC-compliant unsubscribe functionality for mailing lists. All destructive operations require explicit confirmation.

Setup Requirements

  • ProtonMail account (any tier)
  • Proton Bridge application running locally on IMAP port 127.0.0.1:1143 and SMTP port 127.0.0.1:1025
  • Python 3 environment with venv
  • .env configuration file with PROTON_EMAIL and PROTON_BRIDGE_PASSWORD
  • Dependencies installed via pip from requirements.txt

Installation Steps Executed

Initiated clone to ~/proton-mcp with setup sequence: repository clone → virtual environment creation → dependency installation. Configuration via .env file with Proton Bridge credentials.

Available Tools

Email search/retrieval, send, folder management (move between folders, mark read/important), junk filtering with analysis, bulk operations, unsubscribe via RFC 2369/8058 headers, mailing list identification.