bulk_delete
Delete multiple iCloud emails at once using filters like sender, domain, date, size, or unread status. Preview changes with a dry run before removing anything.
Instructions
Delete emails matching any combination of filters. Processes in chunks of 500 with per-chunk timeouts for reliability. Use dryRun: true to preview without making changes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | Only emails since this date (YYYY-MM-DD) | |
| before | No | Only emails before this date (YYYY-MM-DD) | |
| domain | No | Match any sender from this domain (e.g. substack.com) | |
| dryRun | No | If true, preview what would be deleted without actually deleting | |
| larger | No | Only emails larger than this size in KB | |
| sender | No | Match exact sender email address | |
| unread | No | True for unread only, false for read only | |
| account | No | Account name to use (e.g. 'icloud', 'gmail'). Defaults to first configured account. Use list_accounts to see available accounts. | |
| flagged | No | True for flagged only, false for unflagged only | |
| smaller | No | Only emails smaller than this size in KB | |
| subject | No | Keyword to match in subject | |
| hasAttachment | No | Only emails with attachments (client-side BODYSTRUCTURE scan — must be combined with other filters that narrow results to under 500 emails first) | |
| sourceMailbox | No | Mailbox to delete from (default INBOX) |