protonmail-client

A Rust interface to fetch emails from Proton Mail using Proton Bridge. This is a read-only IMAP client that connects over STARTTLS with self-signed certificate support.

The library returns parsed Email structs from email-parser - it does not implement its own email types.

• API Documentation
• CLI usage

Environment variables

CLI

The crate includes a proton-cli binary for command-line access.

# List recent emails
cargo run --release --bin proton-cli -- list --limit 10

# List unseen emails
cargo run --release --bin proton-cli -- list --unseen

# Show a single email
cargo run --release --bin proton-cli -- show 42

# List folders
cargo run --release --bin proton-cli -- folders

# IMAP search
cargo run --release --bin proton-cli -- search "FROM alice@example.com"

# JSON output (for scripting)
cargo run --release --bin proton-cli -- list --json --limit 5

MSRV

The minimum supported Rust version is 1.90.0 (edition 2024).

License

MIT