manage-category
List, create, update, or delete color-coded categories for mail, calendar, and contacts. Deleting does not remove existing labels from messages.
Instructions
Manage the user's master category list (the colour-coded labels available across mail/calendar/contacts). action=list (default) returns categories with id/displayName/color. action=create adds a new category — displayName required, color optional (preset0-preset24, e.g. preset0=Red, preset7=Blue). action=update (alias set — deprecated) changes name/colour by id. action=delete removes a category — this does NOT untag messages already labelled with it; existing messages retain the orphaned label until manually cleaned. Use apply-category to tag/untag specific messages.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action to perform (default: list). 'set' is a deprecated alias for 'update'. | |
| outputVerbosity | No | Output detail level (action=list, default: standard) | |
| displayName | No | Category name (action=create required, action=update optional) | |
| color | No | Color preset, e.g. preset0=Red, preset7=Blue (action=create/update) | |
| id | No | Category ID (action=update/delete, required) | |
| categoryId | No | DEPRECATED: alias for `id`. Will be removed in v3.8.0. |