BYO mailbox email client with agent-native primitives. Turn any IMAP/SMTP account into a programmable email interface.
# Homebrew (macOS/Linux)
brew install tymrtn/tap/envelope-email
# Cargo (free tier — no scoring)
cargo install envelope-email
# From source
git clone https://github.com/tymrtn/envelope-email.git
cd envelope-email
cargo build --release# Add your email account (auto-discovers SMTP/IMAP settings)
envelope-email accounts add --email you@gmail.com --password <app-password>
# Check your inbox
envelope-email inbox
# Read a message
envelope-email read 42
# Send an email
envelope-email send --to someone@example.com --subject "Hello" --body "Hi there"
# Search messages
envelope-email search "FROM john@co.com"envelope-email accounts add --email <email> --password <password>
envelope-email accounts list [--json]
envelope-email accounts remove <id>envelope-email inbox [--folder INBOX] [--limit 50] [--json]
envelope-email read <uid> [--folder INBOX] [--json]
envelope-email search "<query>" [--folder INBOX] [--limit 10] [--json]
envelope-email folders [--json]envelope-email send --to <addr> --subject <sub> --body <body> [--cc <addr>] [--bcc <addr>]envelope-email move <uid> --to-folder Archive [--folder INBOX]
envelope-email copy <uid> --to-folder Important [--folder INBOX]
envelope-email delete <uid> [--folder INBOX]
envelope-email flag add <uid> --flag seen
envelope-email flag remove <uid> --flag flaggedenvelope-email attachment download <uid> [--dir ~/Downloads]envelope-email serve [--port 8080]Every command supports --json for agent/script consumption:
envelope-email inbox --json | jq '.[0].subject'FSL-1.1-ALv2 — see LICENSE for details.
Copyright 2026 Tyler Martin.