proton-bridge-email

⚠Review·Scanned 2/17/2026

This skill sends email via Proton Mail Bridge by decrypting an age-encrypted env file at ~/clawd/secrets/proton.env.age and using the bridge credentials to connect to a local SMTP server. It reads the age identity at ~/.config/age/keys.txt, executes age/encrypt_env.sh (bash scripts/encrypt_env.sh), and includes a download link https://proton.me/mail/bridge.

from clawhub.ai·v2144a21·6.4 KB·0 installs
Scanned from 1.0.0 at 2144a21 · Transparency log ↗
$ vett add clawhub.ai/boilerrat/proton-bridge-emailReview findings below

Proton Bridge Email (age-encrypted)

Authored by Boilermolt + Boiler (Chris).

Use Proton Mail Bridge for local SMTP/IMAP and keep credentials encrypted at rest with age.

What this skill provides

  • A minimal SMTP sender: scripts/send_email.py
  • A helper to encrypt the Bridge env file: scripts/encrypt_env.sh
  • Setup notes: references/proton-bridge-setup.md

Expected local secret location

This skill assumes the encrypted env file is at:

  • ~/clawd/secrets/proton.env.age

And your age identity is at:

  • ~/.config/age/keys.txt

The encrypted file should contain at least:

  • PROTON_EMAIL
  • PROTON_BRIDGE_USER
  • PROTON_BRIDGE_PASS (Bridge “Use this password”, not your Proton web password)
  • SMTP_HOST, SMTP_PORT, SMTP_SECURITY

Quick start

  1. Set up Proton Bridge (Linux) → see references/proton-bridge-setup.md.
  2. Create a temporary plaintext env file (e.g., /tmp/proton.env), then encrypt it:
bash scripts/encrypt_env.sh /tmp/proton.env <age-public-key>
  1. Send a test email:
python3 scripts/send_email.py \
  --to you@example.com \
  --subject "Test" \
  --body "Sent via Proton Bridge."

Notes / gotchas

  • Bridge typically uses a local/self-signed cert for TLS on localhost. The sender script allows it.
  • Bridge must be running for localhost SMTP to work.
  • Do not commit or share secrets; only share the .age encrypted file if you intend to.