mxr unsubscribe

Generated from mxr unsubscribe --help. Edit the clap definitions in crates/daemon/src/cli/ and re-run npm run build in site/ to regenerate.

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), which is rewritten to --search "from:alice@example.com" and acts on the most recent match. Combine with --search to scope an address-wide unsubscribe to a label or date range.

mxr unsubscribe [OPTIONS] [MESSAGE_ID_OR_ADDRESS]...

Arguments

Flag	Description
[MESSAGE_ID_OR_ADDRESS]	…

Options

Flag	Description
--yes	—
--search <SEARCH>	—
--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
--format <FORMAT>	[possible values: table, json, jsonl, csv, ids]
-h, --help	Print help (see a summary with ‘-h’)

Use When

Unsubscribe from a single message id, or from every message by a given sender address. Passing an email address is shorthand for --search "from:<addr>" — the daemon picks the most recent match and uses its List-Unsubscribe header.

Everyday Examples

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

See also

• CLI overview — full command index
• Concepts — query operators, search modes, JSON shapes
• Automation contract — which commands support --format json, --dry-run, stdin