todoist_delete_project
Remove a Todoist project permanently by specifying its ID to clean up your workspace and manage project organization.
Instructions
Delete a project by its ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | The ID of the project to delete |
Implementation Reference
- src/index.ts:1437-1451 (handler)The handler logic for the 'todoist_delete_project' tool. Validates input using isProjectIdArgs type guard, calls todoistClient.deleteProject(projectId), and returns a success message.
if (name === "todoist_delete_project") { if (!isProjectIdArgs(args)) { throw new Error("Invalid arguments for todoist_delete_project"); } await todoistClient.deleteProject(args.projectId); return { content: [{ type: "text", text: `Project ${args.projectId} deleted successfully` }], isError: false, }; } - src/index.ts:462-475 (schema)The Tool object definition specifying the name, description, and input schema (requiring projectId) for the todoist_delete_project tool.
const DELETE_PROJECT_TOOL: Tool = { name: "todoist_delete_project", description: "Delete a project by its ID", inputSchema: { type: "object", properties: { projectId: { type: "string", description: "The ID of the project to delete" } }, required: ["projectId"] } }; - src/index.ts:1083-1121 (registration)Registration of the todoist_delete_project tool (as DELETE_PROJECT_TOOL) in the list of tools returned by the ListToolsRequestSchema handler.
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:823-832 (helper)Type guard helper function isProjectIdArgs used to validate the input arguments for project-related tools, including todoist_delete_project.
function isProjectIdArgs(args: unknown): args is { projectId: string; } { return ( typeof args === "object" && args !== null && "projectId" in args && typeof (args as { projectId: string }).projectId === "string" ); }