bulk_flag
Flag or unflag multiple emails at once using filters like sender, date, subject, or size to organize your iCloud Mail efficiently.
Instructions
Flag or unflag emails matching any combination of filters in bulk
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flagged | Yes | True for flagged only, false for unflagged only | |
| mailbox | No | Mailbox (default INBOX) | |
| sender | No | Match exact sender email address | |
| domain | No | Match any sender from this domain (e.g. substack.com) | |
| subject | No | Keyword to match in subject | |
| before | No | Only emails before this date (YYYY-MM-DD) | |
| since | No | Only emails since this date (YYYY-MM-DD) | |
| unread | No | True for unread only, false for read only | |
| larger | No | Only emails larger than this size in KB | |
| smaller | No | Only emails smaller than this size in KB | |
| hasAttachment | No | Only emails with attachments (client-side BODYSTRUCTURE scan — must be combined with other filters that narrow results to under 500 emails first) | |
| account | No | Account name to use (e.g. 'icloud', 'gmail'). Defaults to first configured account. Use list_accounts to see available accounts. |