proton-mail
Skill4 starsChanged 20 days agoMITView on GitHub
Read and search Proton Mail through the local Proton Bridge (IMAP over STARTTLS on 127.0.0.1). Use when the user mentions Proton Mail, proton-bridge, asks to check/list/search their Proton inbox, read a specific Proton email, or list unread mail. Read-only: it does not send, delete, or move mail. Credentials live at `~/.proton-imap`.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- WojciechJelen/pmailtheir own version, first seen Sep 25, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- WojciechJelen/pmail★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- academic-cvSkill
- academic-jobsSkill
- academic-proseSkill
- adversarial-reviewSkill
- bibtex-genSkill
- chrome-sessionSkill
- clickup-cliSkill
- clickup-todaySkill
- commit-triageSkill
- concept-explainerSkill
- contact-emailSkill
- cover-letterSkill
- dropboxSkill
- handdrawn-schematicSkill
- hep-rumor-millSkill
- journal-club-reviewSkill
- magi-researchSkill
- md2pdf-typoraSkill
- morgenSkill
- overleaf-section-workflowSkill
- overleapSkill
- peer-agent-reviewSkill
- reference-searchSkill
- remarkable-syncSkill
- research-backupSkill
- research-boardSkill
- research-logSkill
- research-portalSkill
- research-proposalSkill
- research-reportSkill
- research-statementSkill
- scienceplot-pySkill
- vastaiSkill
- wide-slide-illustratorSkill
- workshop-paper-reviewSkill
- xkcd-pySkill
- zai-web-searchSkill
- zoom-summarySkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Read and search Proton Mail from the command line through the locally running Proton Bridge app, which exposes a standard IMAP server …
- Distinctive: line 21
If nothing prints, tell the user to start it (it is a desktop/tray app):
- Very specific: line 40
Run the helper with python3 (stdlib only, no deps):
- Distinctive: line 64
Only unseen messages (default 30).
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Proton Mail (via Proton Bridge)
Read and search Proton Mail from the command line through the locally running
Proton Bridge app, which exposes a standard IMAP server (127.0.0.1:1143) over
STARTTLS. All work goes through one helper: scripts/proton_mail.py.
This skill is read-only by design: it lists, searches, and reads messages. It does not send, delete, move, or flag mail.
Prerequisites (check before any operation)
Proton Bridge must be running. Quick check:
pgrep -af protonmail-bridgeIf nothing prints, tell the user to start it (it is a desktop/tray app):
protonmail-bridge --no-window &Credentials file
~/.proton-imapmust exist with KEY=VALUE lines:PROTON_IMAP_USER=you@proton.me PROTON_IMAP_PASS=<bridge-generated password> PROTON_IMAP_HOST=127.0.0.1 PROTON_IMAP_PORT=1143The password is the bridge-specific password shown in the Proton Bridge app under "Mailbox details", NOT the Proton account password. The file should be
chmod 600. If it is missing, ask the user for the bridge username and password (or have them runprotonmail-bridge --clitheninfo), then write the file yourself withumask 077.
Usage
Run the helper with python3 (stdlib only, no deps):
python3 scripts/proton_mail.py <subcommand> [options]Resolve the script path relative to this SKILL.md if the client exposes the
skill directory; otherwise use the absolute path
~/Documents/Project/AI_Project/skills/proton-mail/scripts/proton_mail.py.
folders
List every mailbox with message and unread counts. Good first call to discover
folder names (Proton labels appear as IMAP folders, e.g. Folders/...,
Labels/...).
python3 scripts/proton_mail.py folderslist
Recent messages, newest first. Default 15 from INBOX.
python3 scripts/proton_mail.py list -n 20 -f INBOXEach block shows a ● marker for unread, the date, From, Subject, and a
[uid N] token. Pass that UID to read.
unread
Only unseen messages (default 30).
python3 scripts/proton_mail.py unread -n 50search
IMAP server-side search. Combine filters freely; with no filter it lists all.
python3 scripts/proton_mail.py search --from kaist.ac.kr
python3 scripts/proton_mail.py search --subject invoice --since 01-Jun-2026
python3 scripts/proton_mail.py search --text "poster" --unread -n 10--from/--subject/--textare substring matches.--since DD-Mon-YYYY(e.g.01-Jun-2026) means on/after that date.--unreadrestricts to unseen.-fselects a folder (default INBOX); use-f "All Mail"to search everything.
read
Full content of one message by UID. Prefers the text/plain part, falls back
to HTML. Reading is non-destructive (does NOT mark the message as seen).
python3 scripts/proton_mail.py read 9253
python3 scripts/proton_mail.py read 9253 --headers # headers only
python3 scripts/proton_mail.py read 9253 -f Sent
python3 scripts/proton_mail.py read 9253 --raw > msg.eml # raw RFC822UIDs are stable within a folder, but differ across folders. Always pair a UID with the folder it came from.
Notes & gotchas
- The bridge cert is self-signed for localhost; the helper disables cert
verification deliberately (connection never leaves
127.0.0.1). - INBOX can hold thousands of messages; always bound listings with
-n. - "Connection refused" / "cannot reach IMAP" means the bridge is not running.
- "IMAP login failed" means the bridge password in
~/.proton-imapis stale. Bridge rotates it if the user re-adds the account; refresh from the app. - This skill is read/search only; it does not send, delete, move, or flag mail.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

