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.
Estrelas
3
Ferramentas
—
Disponibilidade
—
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.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Protonmail Rs?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Protonmail Rs precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Protonmail Rs usa?
Protonmail Rs roda localmente via stdio.
Quando Protonmail Rs foi verificado pela última vez?
Última verificação: 2026-10-28. ✉️ Unofficial, pure-Rust Proton Mail client — library, CLI, and MCP server with end-to-end OpenPGP encryption.