todoist_delete_task
Remove a task from Todoist by specifying its unique ID to clear completed items or eliminate outdated entries.
Instructions
Delete a task by its ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | The ID of the task to delete |
Implementation Reference
- src/index.ts:183-196 (schema)Tool schema definition including name, description, and input schema requiring 'taskId'.
const DELETE_TASK_TOOL: Tool = { name: "todoist_delete_task", description: "Delete a task by its ID", inputSchema: { type: "object", properties: { taskId: { type: "string", description: "The ID of the task to delete" } }, required: ["taskId"] } }; - src/index.ts:1083-1121 (registration)Registration of the tool in the ListToolsRequestSchema handler's tools array.
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ // Task tools CREATE_TASK_TOOL, QUICK_ADD_TASK_TOOL, GET_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, COMPLETE_TASK_TOOL, REOPEN_TASK_TOOL, SEARCH_TASKS_TOOL, MOVE_TASK_TOOL, BULK_MOVE_TASKS_TOOL, // Project tools GET_PROJECTS_TOOL, GET_PROJECT_TOOL, CREATE_PROJECT_TOOL, UPDATE_PROJECT_TOOL, DELETE_PROJECT_TOOL, // Section tools GET_SECTIONS_TOOL, CREATE_SECTION_TOOL, UPDATE_SECTION_TOOL, DELETE_SECTION_TOOL, // Label tools CREATE_LABEL_TOOL, GET_LABEL_TOOL, GET_LABELS_TOOL, UPDATE_LABEL_TOOL, DELETE_LABEL_TOOL, // Comment tools CREATE_COMMENT_TOOL, GET_COMMENT_TOOL, GET_COMMENTS_TOOL, UPDATE_COMMENT_TOOL, DELETE_COMMENT_TOOL, ], })); - src/index.ts:1251-1265 (handler)The handler logic within the CallToolRequestSchema: validates args using isTaskIdArgs, calls todoistClient.deleteTask(taskId), and returns success message.
if (name === "todoist_delete_task") { if (!isTaskIdArgs(args)) { throw new Error("Invalid arguments for todoist_delete_task"); } await todoistClient.deleteTask(args.taskId); return { content: [{ type: "text", text: `Task ${args.taskId} deleted successfully` }], isError: false, }; }