Skip to content

mxr label

Generated from mxr label --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/.

Apply a label to a message

mxr label [OPTIONS] <NAME> [MESSAGE_ID]...
Flag Description
<NAME> Label name
[MESSAGE_ID] … Message ID(s). If omitted, reads IDs from stdin when stdin is piped
Flag Description
--search <SEARCH>
--account <ACCOUNT>
--yes
--dry-run
--async Run as a daemon-side background job and poll with mxr jobs
--all Act on every message the search matches, not only the newest 1,000. The daemon resolves the whole set, so the exact count is shown before anything changes, and runs it as one background job that this command waits for. An –all job cannot be undone: preview it with –dry-run first, since the preview is the check
--no-wait With –all, return once the daemon has accepted the job instead of waiting for it. Follow it with mxr jobs <JOB_ID>
--preview-token <TOKEN> With –all, run exactly the messages an earlier --all --dry-run counted (its preview_token; valid for 10 minutes, once)
--format <FORMAT> [possible values: table, json, jsonl, csv, ids]
-h, --help Print help

Apply a label/folder to messages, including piped IDs from search.

Terminal window
mxr label receipts MESSAGE_ID
mxr search 'from:billing@example.com' --format ids | mxr label receipts --yes