Tools in this category
| Tool | Mutating | Description |
|---|---|---|
list_tags |
no | List the current user’s tags (max 200, name-sorted) with an optional name search and per-tag usage counts. 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. |
list_tags
Mutating: no
List the current user’s tags (max 200, name-sorted) with an optional name search and per-tag usage counts. Tags are shared across all entity types.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
search |
string | no | Case-insensitive substring match on tag name. |
includeCounts |
boolean | no | When true, include the number of distinct tagged entities per tag. |
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). |