MCP tool reference
Projects
MCP tools for projects.
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_projects
List projects. Each carries health and progress (done, total, percent), weighted by estimate points where set and excluding canceled issues.
| Parameter | Type | Required | Description |
|---|---|---|---|
initiative | string | no | Initiative name or id |
status | string | no | Comma-separated statuses: backlog, planned, started, paused, completed, canceled |
lead | string | no | Comma-separated user ids, or 'none' for no lead |
team | string | no | Comma-separated team ids |
health | string | no | Comma-separated: on_track, at_risk, off_track |
special | string | no | Comma-separated computed filters, ANDed together: overdue (past target), due_month, no_target_date, stale, no_lead, no_initiative, no_issues, update_overdue, off_track, uncounted (canceled or paused, so outside progress), led_by_me |
sort | string | no | name, target, health, status, updated, -updated, progress, -progress, scope, -scope, lead |
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_project
Create a project, optionally under an initiative and linked to teams.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | |
description | string | no | |
status | "backlog" | "planned" | "started" | "paused" | "completed" | "canceled" | no | |
initiative | string | no | Initiative name or id |
lead | string | no | User email, id, or 'me' |
teams | string[] | yes | Team keys - every project belongs to >=1 team |
startDate | string | no | YYYY-MM-DD |
targetDate | string | no | YYYY-MM-DD |
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_project
Update a project by name or id. Only provided fields change.
| Parameter | Type | Required | Description |
|---|---|---|---|
project | string | yes | Project name or id |
name | string | no | |
description | string | no | |
status | "backlog" | "planned" | "started" | "paused" | "completed" | "canceled" | no | |
initiative | string | no | |
lead | string | no | |
teams | string[] | no | |
startDate | string | no | |
targetDate | string | no | |
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. |
move_project
Move a project to another initiative, team, or workspace. A workspace move takes the issues with it and remaps what is workspace-scoped: states by type, labels recreated by name, assignees who are not members of the target cleared. Admin only, and it needs the team the project lands in.
| Parameter | Type | Required | Description |
|---|---|---|---|
project | string | yes | Project name or id |
initiative | string | null | no | Target initiative name or id, or null to detach |
team | string | no | Target team key or id |
workspace | string | no | Target workspace slug, name, or id. Requires team. The source is this connection's active workspace, so set_active_workspace first when moving out of another one. |