update_todo_status
Mark a task as complete or incomplete in your software project plan by providing its ID and desired status.
Instructions
Update the completion status of a todo item
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| todoId | Yes | ID of the todo item | |
| isComplete | Yes | New completion status |
Implementation Reference
- src/index.ts:319-345 (handler)The MCP tool handler for 'update_todo_status' which validates the current goal exists, extracts todoId and isComplete from arguments, calls storage.updateTodoStatus, and returns the updated todo as JSON.
case 'update_todo_status': { if (!this.currentGoal) { throw new McpError( ErrorCode.InvalidRequest, 'No active goal. Start a new planning session first.' ); } const { todoId, isComplete } = request.params.arguments as { todoId: string; isComplete: boolean; }; const updatedTodo = await storage.updateTodoStatus( this.currentGoal.id, todoId, isComplete ); return { content: [ { type: 'text', text: JSON.stringify(updatedTodo, null, 2), }, ], }; } - src/index.ts:191-208 (schema)Input schema for the 'update_todo_status' tool, defining required parameters todoId (string) and isComplete (boolean).
{ name: 'update_todo_status', description: 'Update the completion status of a todo item', inputSchema: { type: 'object', properties: { todoId: { type: 'string', description: 'ID of the todo item', }, isComplete: { type: 'boolean', description: 'New completion status', }, }, required: ['todoId', 'isComplete'], }, }, - src/index.ts:111-210 (registration)Registration of tools list including 'update_todo_status' in the ListToolsRequestHandler.
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ { name: 'start_planning', description: 'Start a new planning session with a goal', inputSchema: { type: 'object', properties: { goal: { type: 'string', description: 'The software development goal to plan', }, }, required: ['goal'], }, }, { name: 'save_plan', description: 'Save the current implementation plan', inputSchema: { type: 'object', properties: { plan: { type: 'string', description: 'The implementation plan text to save', }, }, required: ['plan'], }, }, { name: 'add_todo', description: 'Add a new todo item to the current plan', inputSchema: { type: 'object', properties: { title: { type: 'string', description: 'Title of the todo item', }, description: { type: 'string', description: 'Detailed description of the todo item', }, complexity: { type: 'number', description: 'Complexity score (0-10)', minimum: 0, maximum: 10, }, codeExample: { type: 'string', description: 'Optional code example', }, }, required: ['title', 'description', 'complexity'], }, }, { name: 'remove_todo', description: 'Remove a todo item from the current plan', inputSchema: { type: 'object', properties: { todoId: { type: 'string', description: 'ID of the todo item to remove', }, }, required: ['todoId'], }, }, { name: 'get_todos', description: 'Get all todos in the current plan', inputSchema: { type: 'object', properties: {}, }, }, { name: 'update_todo_status', description: 'Update the completion status of a todo item', inputSchema: { type: 'object', properties: { todoId: { type: 'string', description: 'ID of the todo item', }, isComplete: { type: 'boolean', description: 'New completion status', }, }, required: ['todoId', 'isComplete'], }, }, ], })); - src/storage.ts:108-124 (helper)Helper method in storage class that locates the todo by ID within the goal's plan, updates its completion status and timestamps, persists to file, and returns the updated todo.
async updateTodoStatus(goalId: string, todoId: string, isComplete: boolean): Promise<Todo> { const plan = await this.getPlan(goalId); if (!plan) { throw new Error(`No plan found for goal ${goalId}`); } const todo = plan.todos.find((t: Todo) => t.id === todoId); if (!todo) { throw new Error(`No todo found with id ${todoId}`); } todo.isComplete = isComplete; todo.updatedAt = new Date().toISOString(); plan.updatedAt = new Date().toISOString(); await this.save(); return todo; }