selfmail

selfmail

selfmail sends an email to a pre-configured "me" address with a single command, over Resend. It runs anywhere — a laptop, a cron job, CI, a cloud runner, or an AI agent — with no GUI and no local mail server. Reach for it whenever a task should end with "...and email it to me."

Invocation

Prefer an installed binary; otherwise run it straight from PyPI with uvx:

if command -v selfmail >/dev/null; then selfmail "$@"
else uvx selfmail "$@"; fi

Configure (once)

selfmail init        # paste a Resend key (Sending access); it emails you a test

Or, for CI / headless / agents, skip the file and use environment variables:

export RESEND_API_KEY=re_...
export [email protected]
export [email protected]   # or [email protected] once verified

selfmail doctor reports what's configured without sending.

Common usage

selfmail "deploy finished"                       # body only; subject defaults to a timestamp
selfmail -s "build" "all green on main"          # explicit subject
some-command 2>&1 | selfmail -s "cron output"    # body from stdin (pipe)
selfmail -s "reports" -a a.pdf -a b.csv "see attached"   # multiple attachments
selfmail --html "<h1>Shipped</h1>"               # HTML body
selfmail --to [email protected] "heads up"         # one-off different recipient

MCP server

For agents that speak the Model Context Protocol, run it as a server instead of shelling out:

uvx --from 'selfmail[mcp]' selfmail mcp

It exposes one tool — send_email(subject, body, to?, html?) — using the same configuration as the CLI.

Exit codes

• 0 — sent.
• 1 — the send failed (network error, or Resend rejected the message).
• 2 — configuration or usage error (no key, missing recipient/sender, bad flag).

Gotchas

• The recipient defaults to the configured "me" address — it's "email myself". Use --to for the rare one-off to someone else.
• There is no default sender; it comes from config (set by init, or SELFMAIL_FROM). Resend's shared [email protected] only delivers to your own Resend account address — fine for self-email; verify a domain to email anyone else.
• A 403 with an "only delivers to your own address" hint means a sender ↔ account mismatch — set --from to a verified-domain address.