v3.1.0: Find email links and unsubscribe opportunities

Mail.app CLI 3.1.0 makes the destinations behind email links available directly in your terminal. Find the real URL behind “unsubscribe here,” inspect one message, or discover unsubscribe opportunities across whole folders.

Find unsubscribe opportunities

• Use unsubscribe show MESSAGE_ID to inspect local mailing-list headers, HTML footer links, and plain-text unsubscribe or preference controls.
• Use unsubscribe scan MAILBOX... to traverse entire folders, or add --all-accounts to include every enabled account.
• Review results grouped by mailing-list identity, with provisional fallback groups clearly labeled. Exact destinations retain their source and message evidence, including controls found only in older messages.
• Resume an interrupted or time-limited scan from its private checkpoint. Retry incomplete local sources when they become available, or restart for fresh observations.
• See explicit coverage, pending work, and extraction exceptions. Recovered links remain available when a local source is partial or missing.

Access any email link

links MESSAGE_ID exposes labels and full destinations. Use show --links for links beside the message body, or consume structured link inventories from show and messages read. Personalized URL parameters and MIME source information are retained.

Discovery is read-only: it never opens or fetches destinations, sends mail, or changes subscriptions. Unsubscribe discovery inspects all supported local body alternatives without asking Mail to render or download missing content.

mail-app-cli unsubscribe show 100001 --json
mail-app-cli unsubscribe scan INBOX --all-accounts --json
mail-app-cli links 100001 --json

Install or update

CGO_ENABLED=1 go install github.com/0xSMW/mail.app-cli/v3/cmd/mail-app-cli@v3.1.0

Requires macOS, Go 1.25 or newer, and Xcode Command Line Tools. Keep Automation and Full Disk Access enabled for the app running the CLI.