Hermes Proton

Proton Mail, Calendar, Contacts and Drive for a Hermes Agent, through an MIT-licensed client built from Proton's own open-source Go libraries (go-srp, go-proton-api) — no Proton Bridge and no paid plan. Reads, searches and sends mail (attachments, scheduled send, labels, folders), manages calendar events and RSVPs, contacts (signed/encrypted vCards), and Drive (upload, download, move, rename, trash, public share links). Sign-in runs in a terminal via `hermes proton login` and the account password is never taken through chat; sending is refused until a recipient allowlist is set and every send is gated by Hermes's pre_tool_call approval.

Good to know before installing

Talks to Proton's private, undocumented web API over the network; stores a per-account session file (0600) holding OAuth-style tokens and the derived key passphrase (never the password) under the profile's plugin-data folder, and on first load copies any sessions from the standalone client's `~/.config/protonlite` into it; reads local files you approve for attachments and Drive uploads and writes downloaded attachments and Drive files under that plugin-data folder; shells out to gpg for calendar/Drive key provisioning; `proton_schedule_followup` creates one-shot Hermes cron jobs (read-only Proton toolset) that run unattended and deliver to your home channel; no self-update, no downloaded binaries, no telemetry.

From the plugin's catalog listing.

How to install

Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install hermes-proton
Said no? Turn it on later:
hermes plugins enable hermes-proton
Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category: Work & business
Maintained by: Maytrella007 (Community)
Needs: No API keys declared
Adds tools: proton_login proton_accounts proton_unread proton_list proton_read proton_send proton_draft proton_mark proton_delete proton_get_attachment proton_search proton_gather_context proton_labels proton_calendar proton_contacts proton_contact proton_drive_list proton_drive_download proton_drive_create_folder proton_drive_upload proton_drive_move proton_drive_rename proton_drive_delete proton_drive_share
Works on: linux, macos
Needs Hermes: 0.22.0 or newer
Version: 0.28.0
In the catalog: 2026-10-25

Full setup & settings ↗Source code ↗

More in work & business

All work & business plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins