Skip to content

mxr unsubscribe

Generated from mxr unsubscribe --help. After editing crates/daemon/src/cli/, update and review the snapshots with scripts/cargo-test -p mxr --test integration cli_help::, then rebuild site/.

Unsubscribe from a mailing list.

Positional argument accepts either a message id (uses the List-Unsubscribe header on that exact message) or an email address (alice@example.com). An address sends one request, from the newest message from that sender with a usable List-Unsubscribe method. On the same date, one-click beats a link, and a link beats mailto. Several addresses each get their own request. A sender that runs several lists needs one message id per list. --dry-run shows the requests before anything is sent. Combine with --search to scope an address to a label or date range.

mxr unsubscribe [OPTIONS] [MESSAGE_ID_OR_ADDRESS]...
Flag Description
[MESSAGE_ID_OR_ADDRESS] …
Flag Description
--yes
--search <SEARCH> Scope an address’s unsubscribe to matching mail. Not with –purge, which acts on the whole sender footprint
--account <ACCOUNT>
--dry-run
--purge Unsubscribe, then mark read and archive the sender’s whole footprint
--archive-on-no-method With –purge, archive the footprint even if no List-Unsubscribe method exists
--keep-mail With –purge, unsubscribe using the previewed method and keep existing mail
--preview-token <PREVIEW_TOKEN> Commit an earlier –purge –dry-run preview exactly once. Requires –yes
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help (see a summary with ‘-h’)

Unsubscribe from a single message id, or from a sender by email address. An address sends one request, from the newest message from that sender with a usable List-Unsubscribe method. On the same date, one-click beats a link, and a link beats mailto. Several addresses each get their own request. A sender that runs several lists needs one message id per list. --dry-run shows the request. Combine with --search to scope the address.

Terminal window
mxr unsubscribe alice@example.com --dry-run
mxr unsubscribe alice@example.com bob@example.com --yes
mxr unsubscribe MESSAGE_ID --dry-run
mxr unsubscribe --search 'list:<news.example.com>' --dry-run