change_task_status
Update task progress by moving it to a different stage within a project board, enabling workflow management and status tracking.
Instructions
Change the status/stage of a task
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | Board ID | |
| task_id | Yes | Task ID | |
| stage_id | Yes | New stage ID |
Implementation Reference
- src/tools/tasks.ts:129-137 (handler)The handler function that executes the change_task_status tool by sending a PUT request to update the task's stage_id.async (args) => { const { board_id, task_id, stage_id } = args; const response = await api.put(`/projects/${board_id}/tasks/${task_id}`, { property: 'stage_id', value: stage_id, }); return formatResponse(response.data); }
- src/tools/tasks.ts:124-128 (schema)Zod input schema defining parameters for the change_task_status tool.{ board_id: z.number().int().positive().describe("Board ID"), task_id: z.number().int().positive().describe("Task ID"), stage_id: z.number().int().positive().describe("New stage ID"), },
- src/tools/tasks.ts:120-138 (registration)Registration of the change_task_status tool on the MCP server using server.tool().// Change task status/stage server.tool( "change_task_status", "Change the status/stage of a task", { board_id: z.number().int().positive().describe("Board ID"), task_id: z.number().int().positive().describe("Task ID"), stage_id: z.number().int().positive().describe("New stage ID"), }, async (args) => { const { board_id, task_id, stage_id } = args; const response = await api.put(`/projects/${board_id}/tasks/${task_id}`, { property: 'stage_id', value: stage_id, }); return formatResponse(response.data); } );