An unofficial, pure-Rust Proton Mail client — library, CLI, and MCP server.
An unofficial, pure-Rust Proton Mail client: a library (proton-core), a
command-line tool (protonmail-cli), and an MCP server (proton-mcp). End-to-end
OpenPGP encryption and SRP authentication are byte-compatible with the official
Proton clients, built on Proton's own Rust crates
(, ).
✉️ Unofficial, pure-Rust Proton Mail client — library, CLI, and MCP server with end-to-end OpenPGP encryption.
星數
3
工具
—
可用率
—
proton-crypto
proton-srp
Unofficial, not affiliated with Proton AG. Use at your own risk.
Validated against a live account: SRP login (incl. CAPTCHA), session resume, key
unlock, send (E2E), list, read + decrypt + signature verify all work.
Contacts (read): list contacts + contact emails; addresses listing.
Local cache + sync: SQLite cache fed by the Proton event stream (sync); offline cached reads (list --cached).
Encrypted full-text search: build a local FTS5 index over decrypted bodies (index) and search them privately/offline (search) — the server never sees the query.
Observability
Verbose logging (tracing) — init_tracing(verbose); logs every login stage, key-unlock step, encrypt/decrypt op, send-pipeline stage, and HTTP request/response. Secrets and plaintext are never logged.
protonmail-cli — commands
Every command and flag is documented in docs/CLI.md (generated
from --help). Cheat-sheet of the full surface:
<REF> = exact message ID or free text (unique search match); <ID> = exact id. --json on any
command for machine output. CAPTCHA: login auto-opens it; solve via console snippet / bookmarklet,
or pass --captcha-token, or --captcha-chrome (isolated, auto-closing window).
proton-mcp — MCP server (for LLM agents)
Reuses a protonmail-cli login session (the agent never sees the password). Transports: stdio (default) and Streamable HTTP (--http <addr>). Verbose via -v. Source is one file per tool under src/tools/.
56 tools — full parity with the CLI (auth/watch/export aside):
Local cache / search:sync_cache, index_cache, search_local.
Safety: destructive/structural tools (send, move, trash, delete, empty_folder, drafts, filters, labels, settings, …) take confirm and return a dry-run preview unless confirm: true (or the server is started with --allow-writes); empty_folder/delete_messages previews carry an explicit irreversibility warning. Benign toggles (mark_*, star_*, snooze_*) and all reads execute directly. Sending defaults to your primary address (first alias by Order) — pass from to pick another alias. Reads return the signature verdict; CAPTCHA is never auto-solved (returns "run protonmail-cli login").
cargo test --workspace # offline: crypto round-trips, transport, HV, api, cli, mcp
# live (real account; opt-in):
PROTON_TEST_USER=… PROTON_TEST_PASSWORD=… [PROTON_TEST_TOTP=…] [PROTON_TEST_SEND=1] \
cargo test -p proton-core --test live -- --nocapture --test-threads=1
Security
Mailbox password never written to disk in cleartext; key passphrase + tokens in the OS keychain.
Address-key token signatures verified on unlock; SRP server proof + signed modulus verified on login.
TLS via rustls. Verbose logs exclude all secrets and plaintext.
Scope / deferred
Implemented: full mail (read/threads, search, send/reply/forward incl. PGP-external and encrypted-outside, attachments, organize), drafts, Sieve filters, mail settings (read) + spam/ham/unsubscribe/empty-folder/snooze, contacts (read) + addresses, event-sync + SQLite cache, local encrypted full-text search, HTML sanitization of message bodies, CLI, MCP, CAPTCHA, verbose logging.
Not implemented (deliberately, to avoid shipping untested code):
Key Transparency (epoch / VRF / certificate-transparency chain) — proton-crypto exposes only result types; the full verification is a large standalone effort. Recipient keys are trusted as the server returns them.
FIDO2 / WebAuthn 2FA — needs a hardware key + a CTAP client + live testing; login detects FIDO2-only accounts and returns a clear error. Use TOTP or an app/bridge password.
Issues and PRs welcome — see CONTRIBUTING.md. Run
cargo fmt --all --check, cargo clippy --all-targets --all-features -- -D warnings,
and cargo test --workspace before opening a PR. Release process:
RELEASING.md.
Security
This client handles credentials, private keys, and plaintext mail. Report
vulnerabilities privately per SECURITY.md — do not open a public
issue.
Disclaimer: Unofficial, not affiliated with or endorsed by Proton AG.
"Proton", "Proton Mail" and related marks belong to Proton AG. Use at your own
risk.