folders
List, create, move, or delete mail folders; retrieve folder statistics for pagination planning.
Instructions
Manage mail folders (tool-level destructiveHint=true because delete permanently removes a folder; list and stats are read-only sub-actions despite the annotation). action=list (default) returns the folder tree with id/displayName/parentFolderId (toggle includeItemCounts for unread/total, includeChildren for hierarchy). action=create makes a new folder under the inbox (or under folder/folderId/folderName) and returns its id. action=move relocates emails (emailIds array) into targetFolder. action=stats returns counts (totalItemCount/unreadItemCount) suitable for pagination planning — pair with outputVerbosity to limit noise. action=delete permanently removes a folder and its contents — there is no recycle-bin recovery.
Input 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.) |