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

1.2 KiB

2026-02-24 Session Notes

Proton MCP Server Setup Initiated

Nicholai requested setup of the proton-mcp project from GitHub (ccunning2/proton-mcp). Session began with research into the project's purpose and requirements. The proton-mcp server is a Model Context Protocol integration for ProtonMail that enables email management, spam detection, and mailing list unsubscribe automation through Claude Desktop.

Project Overview

Proton MCP provides tools for:

  • Email search, retrieval, sending, and folder management
  • Junk email detection with pattern-based scoring (unlikely/low/medium/high)
  • RFC 2369/8058-compliant unsubscribe header parsing and bulk operations
  • Full attachment metadata access

Setup Requirements Identified

  • Requires ProtonMail account and Proton Bridge application running locally
  • Python-based implementation with virtual environment setup
  • Environment variables needed: PROTON_EMAIL and PROTON_BRIDGE_PASSWORD
  • IMAP/SMTP defaults: 127.0.0.1:1143 and 127.0.0.1:1025
  • Destructive actions require explicit confirmation for safety

Next Steps

Repository clone was initiated to ~/proton-mcp. Setup workflow would follow: venv creation, dependency installation via pip, .env configuration, and Claude Desktop integration.