MCP tool reference
Labels
MCP tools for labels.
Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.
list_labels
List all labels in the workspace.
| Parameter | Type | Required | Description |
|---|---|---|---|
usage | boolean | no | Add issueCount and openIssueCount per label (admin only) |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
create_label
Create a workspace label.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Label name |
color | string | no | Hex color, e.g. #8b8b8b |
description | string | no | Free text. Start with 'consumed by' to mark a label an automation depends on |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
update_label
Rename, recolour or describe a label (admin only). Only provided fields change. A rename keeps the id and rewrites saved view filters; it fails if another label has the name, so merge instead.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Label id |
name | string | no | |
color | string | no | Hex color, e.g. #5e6ad2 |
description | string | null | no | Description, or null to clear |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
merge_label
Merge a label into another (admin only): every issue moves to the target, duplicates collapse, and the source label is deleted.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Source label id, deleted by the merge |
into | string | yes | Target label id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
delete_label
Delete a label (admin only). It is removed from every issue and saved view filter.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Label id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |