Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_tags |
no | List the current user’s tags (name-sorted by default, page size 20/max 50) with an optional name search and per-tag usage counts, sortable by name, total usage, or a specific entity type. Tags are shared across all entity types. |
create_tag |
yes | Create a tag with a unique name and an optional hex color (#RGB or #RRGGBB). Logged in the MCP audit trail. |
update_tag |
yes | Rename a tag or change its hex color. Only supplied fields change; renaming updates every entity tagged with it. Logged in the MCP audit trail. |
delete_tag |
yes | Delete a tag and detach it from every entity it was applied to. The entities themselves are untouched. Logged in the MCP audit trail. |
bulk_update_tags |
yes | Rename or recolour many tags in one call. Tag names are case-insensitively unique per user, so a rename onto a name already in use fails for that row — there is no merge. |
bulk_delete_tags |
yes | Delete many tags in one call. Every entity carrying one of them loses the tag; the entities themselves are untouched. Prefer this over looping delete_tag. |
list_tags
Mutating: no
List the current user’s tags (name-sorted by default, page size 20/max 50) with an optional name search and per-tag usage counts, sortable by name, total usage, or a specific entity type. Tags are shared across all entity types.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
page |
number | no | Page number (default: 1). |
limit |
number | no | Items per page (default: 20, max: 50). |
search |
string | no | Case-insensitive substring match on tag name. |
sortBy |
string (name | total | client | project | task | transaction | invoice | subscription | time_entry | document) |
no | Field to sort by; defaults to name. |
sortOrder |
string (asc | desc) |
no | Sort direction; defaults to asc. |
create_tag
Mutating: yes
Create a tag with a unique name and an optional hex color (#RGB or #RRGGBB). Logged in the MCP audit trail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Tag name (unique per user, case-insensitive). |
color |
string | no | Optional hex color, #RGB or #RRGGBB (e.g. "#3b82f6"). |
update_tag
Mutating: yes
Rename a tag or change its hex color. Only supplied fields change; renaming updates every entity tagged with it. Logged in the MCP audit trail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Tag ID (UUID). |
name |
string | no | New tag name (unique per user, case-insensitive). |
color |
string | no | New hex color, #RGB or #RRGGBB (e.g. "#3b82f6"). |
delete_tag
Mutating: yes
Delete a tag and detach it from every entity it was applied to. The entities themselves are untouched. Logged in the MCP audit trail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Tag ID (UUID). |
bulk_update_tags
Mutating: yes
Rename or recolour many tags in one call. Tag names are case-insensitively unique per user, so a rename onto a name already in use fails for that row — there is no merge.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
updates |
array | yes | Per-id patches to apply. |
Items of updates:
id(string) — Tag ID (UUID) from list_tags.data(object) — Partial tag fields: name (unique per user) and color (hex such as #3b82f6, or null to clear).
bulk_delete_tags
Mutating: yes
Delete many tags in one call. Every entity carrying one of them loses the tag; the entities themselves are untouched. Prefer this over looping delete_tag.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ids |
array | yes | Tag IDs (UUIDs) to delete, as returned by list_tags. |