diff --git a/memory/2026-02-24-protonmail-mcp-server-setup.md b/memory/2026-02-24-protonmail-mcp-server-setup.md new file mode 100644 index 000000000..4dd300b93 --- /dev/null +++ b/memory/2026-02-24-protonmail-mcp-server-setup.md @@ -0,0 +1,23 @@ +# 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. \ No newline at end of file diff --git a/memory/memories.db-shm b/memory/memories.db-shm index 657db7e1b..46d37ce23 100644 Binary files a/memory/memories.db-shm and b/memory/memories.db-shm differ diff --git a/memory/memories.db-wal b/memory/memories.db-wal index 615283b86..6b7ff655d 100644 Binary files a/memory/memories.db-wal and b/memory/memories.db-wal differ