manage_emails
Organize your inbox by moving, deleting, archiving, flagging, or categorizing emails. Supports individual and batch actions for efficient email management.
Instructions
Manage emails with multiple actions. Supports moving, deleting, archiving, flagging, and categorizing emails. Actions include: move_single, move_all, delete_single, delete_multiple, delete_all, archive_single, archive_multiple, flag_single, flag_multiple, categorize_single, categorize_multiple. Returns: {success: boolean, message: string, moved_count: integer, failed_count: integer, errors: array}. Note: Invalid cache_number returns appropriate error message.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: 'move_single' to move a single email, 'move_all' to move all emails from a folder, 'delete_single' to delete a single email, 'delete_multiple' to delete multiple emails in ONE batch call (provide cache_numbers array with all items), 'delete_all' to delete all emails from a folder, 'archive_single' to archive a single email, 'archive_multiple' to archive multiple emails in ONE batch call, 'flag_single' to flag a single email, 'flag_multiple' to flag multiple emails in ONE batch call, 'categorize_single' to categorize a single email, 'categorize_multiple' to categorize multiple emails in ONE batch call | |
| categories | No | List of category names to apply (e.g., ['Important', 'Work']). Required for 'categorize_single' and 'categorize_multiple' actions | |
| flag_status | No | Flag status: 'flagged' to mark as flagged, 'complete' to mark as complete. Required for 'flag_single' and 'flag_multiple' actions | |
| cache_number | No | Cache number from browse_email_cache (e.g., 1, 2, 3). Required for 'move_single', 'delete_single', 'archive_single', 'flag_single', and 'categorize_single' actions | |
| cache_numbers | No | List of cache numbers from browse_email_cache (e.g., [1, 2, 3]). Required for 'delete_multiple', 'archive_multiple', 'flag_multiple', and 'categorize_multiple' actions. IMPORTANT: Pass ALL cache numbers in a SINGLE call - do NOT call multiple times for individual items | |
| source_folder | No | Source folder path (e.g., 'Inbox', 'Archive/2024'). Required for 'move_all' and 'delete_all' actions | |
| destination_folder | No | Destination folder path (e.g., 'Archive/2024', 'Inbox/Projects'). Required for 'move_single' and 'move_all' actions |