MCP tool reference
Initiatives
MCP tools for initiatives.
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_initiatives
List initiatives with their projects, health and progress. An initiative's progress excludes its canceled and paused projects entirely; progress.excludedProjects says how many were left out.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | no | Comma-separated: planned, active, completed, canceled |
lead | string | no | Comma-separated user ids, or 'none' for no lead |
health | string | no | Comma-separated: on_track, at_risk, off_track |
special | string | no | Comma-separated computed filters, ANDed together: overdue (past target), due_quarter, no_target_date, stale, no_lead, no_projects, no_counted_work, update_overdue, off_track, has_excluded (holds canceled or paused projects), led_by_me |
sort | string | no | name, target, health, status, updated, -updated, progress, -progress, -projects |
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_initiative
Create an initiative (top-level goal that groups projects).
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | |
description | string | no | |
status | "planned" | "active" | "completed" | "canceled" | no | |
lead | string | no | The person in charge: user email, id, or 'me' |
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_initiative
Update an initiative by name or id.
| Parameter | Type | Required | Description |
|---|---|---|---|
initiative | string | yes | Initiative name or id |
name | string | no | |
description | string | no | |
status | "planned" | "active" | "completed" | "canceled" | no | |
lead | string | no | The person in charge: user email, id, or 'me' |
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_initiative
Move an initiative to another workspace with its projects and their issues. The initiative is recreated in the target and the original is canceled. Admin in both workspaces.
| Parameter | Type | Required | Description |
|---|---|---|---|
initiative | string | yes | Initiative name or id |
workspace | string | yes | Target workspace slug, name, or id |
team | string | yes | Team in the target workspace the projects land in |