folders
Destructive
List, create, delete mail folders; move emails between folders; retrieve folder counts for pagination planning.
Instructions
Manage mail folders. action=list (default) lists folders. action=create creates a folder. action=move moves emails between folders. action=stats gets folder counts for pagination planning. action=delete removes a folder.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action to perform (default: list) | |
| includeItemCounts | No | Include counts of total and unread items (action=list) | |
| includeChildren | No | Include child folders in hierarchy (action=list) | |
| name | No | Name of the folder to create (action=create, required) | |
| parentFolder | No | Parent folder name, default is root (action=create) | |
| emailIds | No | Comma-separated list of email IDs to move (action=move, required) | |
| targetFolder | No | Folder name to move emails to (action=move, required) | |
| sourceFolder | No | Source folder name, default is inbox (action=move) | |
| folder | No | Folder name (inbox, sent, drafts, etc.). Default: inbox (action=stats) | |
| outputVerbosity | No | Output detail level (action=stats, default: standard) | |
| folderId | No | Folder ID to delete (action=delete) | |
| folderName | No | Folder name to delete — resolved to ID (action=delete). Cannot delete protected folders (Inbox, Drafts, Sent, etc.) |