MCP Todo.txt Integration

Instructions

Implementation Reference

• src/tools.ts:88-106 (handler)

  The handler function for the 'delete-task' tool. It loads tasks, validates the task ID using getTaskIndex, deletes the task by splicing it from the array if valid, saves the updated tasks, and returns success or error message.

  async ({ taskId }) => {
      const tasks = await loadTasks();
      const idx = getTaskIndex(taskId, tasks);
      if (idx === null) {
          return {
              content: [
                  { type: "text", text: "Invalid task ID." },
              ],
              isError: true,
          };
      }
      tasks.splice(idx, 1);
      await saveTasks(tasks);
      return {
          content: [
              { type: "text", text: "Task deleted successfully." },
          ],
      };
  }

• src/tools.ts:87-87 (schema)

  Input schema for the 'delete-task' tool, requiring a numeric taskId.

  { taskId: z.number() },

• src/tools.ts:84-107 (registration)

  Registration of the 'delete-task' tool using server.tool(), including name, description, schema, and handler.

  server.tool(
      "delete-task",
      "Delete a task by its 1-based ID.",
      { taskId: z.number() },
      async ({ taskId }) => {
          const tasks = await loadTasks();
          const idx = getTaskIndex(taskId, tasks);
          if (idx === null) {
              return {
                  content: [
                      { type: "text", text: "Invalid task ID." },
                  ],
                  isError: true,
              };
          }
          tasks.splice(idx, 1);
          await saveTasks(tasks);
          return {
              content: [
                  { type: "text", text: "Task deleted successfully." },
              ],
          };
      }
  );

• src/tools.ts:14-18 (helper)

  Helper function used by delete-task (and others) to convert 1-based taskId to 0-based array index, returning null if invalid.

  function getTaskIndex(taskId: number, tasks: Item[]): number | null {
      const idx = taskId - 1;
      if (idx < 0 || idx >= tasks.length) return null;
      return idx;
  }