Mailing lists and sender preferences

Unsubscribe from a mailing list

When a synchronized message advertises a supported unsubscribe method, review it first:

icloud mail unsubscribe msg_… --dry-run

Then execute the reviewed method:

icloud mail unsubscribe msg_… --yes

If the preview offers more than one safe choice, select the method ID it returned:

icloud mail unsubscribe msg_… \
  --method mailto:2 \
  --yes

The CLI supports standards-based unsubscribe flows rather than opening arbitrary message links on your behalf.

Mark a sender as VIP

icloud mail senders vip teammate@example.com

Use the preference in local filters:

icloud mail search --vip
icloud mail messages list --vip

Clear it with:

icloud mail senders unvip teammate@example.com

Mark a sender as blocked

icloud mail senders block noisy-list@example.com

Then filter locally:

icloud mail search --blocked

Clear the preference:

icloud mail senders unblock noisy-list@example.com

Inspect sender preferences

icloud mail senders list
icloud mail senders show teammate@example.com

VIP and blocked are local CLI preferences. They do not create Apple Mail rules, change Contacts, or automatically move/delete mail. They simply add useful context and filters for you or an agent.