proton-cli

proton-cli

Proton services from the terminal

WHO USES ITProton user · Terminal person · Agent user

Install to use

Runs Proton Mail, Drive, Calendar, Pass and Contacts from the terminal.

★ 70▲ 3 HNAs of 09-16 21:00 UTC

70 stars · checked on GitHub 09-15 19:34 UTC GitHub check 30 h late · no 7-day star increase observed (GH Archive) (as of 09-16 21:00 UTC) · 3 Show HN points observed 09-16 05:47 UTC

NEW 0h OLD WHEN SEEN

TESIGN TAKE

No bridge, no proxy: the encryption happens on your machine, and that is the whole pitch.

AT A GLANCE

WHY IT MATTERS

A Proton account can only be used through the browser or the apps, which keeps it out of scripts and cron. proton-cli puts Mail, Drive, Calendar, Pass and Contacts behind one binary, handling SRP login and PGP encryption on your machine with Proton's own libraries. Every listing comes out as JSON or YAML, and anything that changes state takes --dry-run. Linux, macOS and Windows under MIT; a community project unaffiliated with Proton AG, so mind Proton's terms yourself.

BUILD FROM THIS

A cron job that pulls unread mail each morning for a summary
A release script that uploads reports to a Drive folder
An agent hooked to mail and calendar via proton skill

WHO IT'S FOR

Proton user: wants mail and files automated by script
Terminal person: prefers the account without a browser
Agent user: letting an agent read mail and calendar

START IN 5 MINUTES

$ curl -fsSL https://raw.githubusercontent.com/roman-16/proton-cli/main/scripts/install.sh | sh
$ irm https://raw.githubusercontent.com/roman-16/proton-cli/main/scripts/install.ps1 | iex
# Also on Homebrew, winget, APT, AUR, Nix, npm and as signed binaries
$ proton account login
$ proton mail messages list --unread
# Every command reads proton <app> <collection> <verb> · proton-cli works too

CAVEATS

Community project unaffiliated with Proton AG; mind Proton's terms
It handles your password and keys; read the Security doc first

RECEIPT

SIMILAR TOOLS

Up to five from PRODUCTIVITY by ★ total: edited entries first, then repository cards; this entry is highlighted. Drawn from the same stored snapshot as the rankings — a comparison, not a recommendation. As of 09-16 21:00 UTC

NAME	★ TOTAL	▲ 7d	LICENSE	PLATFORM	LAST PUSH
Hermes AgentSelf-improving personal agent	★ 246k	▲ +375	MITpermissive	linux · macos · windows · android · cli	2026-09-15
proton-cliProton services from the terminalTHIS ENTRY	★ 70	—	MITpermissive	linux · macos · windows · cli	2026-09-15
immich-app/immichCARD	★ 114k	▲ +82	AGPL-3.0copyleft	—	2026-09-13
stirling-tools/stirling-pdfCARD	★ 91.9k	▲ +54	Licence unconfirmedunconfirmed	—	2026-09-13
sherlock-project/sherlockCARD	★ 91.5k	▲ +64	MITpermissive	—	2026-09-13