Tools

List Task Lists

Retrieve all task lists for the authenticated user. Returns the complete set of task lists including their IDs, titles, and last-updated timestamps. Use this to discover available lists before operating on tasks within them.

Update Task

Update properties of an existing task. Supports modifying the title, notes, due date, and completion status. Only the provided fields will be updated; omitted fields remain unchanged.

List Tasks

Retrieve tasks from one task list or, when taskListId is omitted, from every task list. Supports filtering by completion status, due date range, completion date range, and last modification time. Returns all matching tasks with task-list context and pagination handled automatically.

Move Task

Move a task to a different position, parent, or task list. Can reorder a task among its siblings, nest it under a parent task as a subtask, or transfer it to an entirely different task list.

Get Task

Retrieve a single task by its ID from a specified task list. Returns the full task details including title, notes, status, due date, and hierarchy information.

Create Task List

Create a new task list with the specified title. Returns the newly created list with its assigned ID.

Update Task List

Update the title of an existing task list. Provide the task list ID and the new title.

Clear Completed Tasks

Remove all completed tasks from a task list in a single operation. Cleared tasks become hidden and will no longer appear in default task listings.

Delete Task List

Permanently delete a task list and all tasks within it. This action cannot be undone.

Create Task

Create a new task in a specified task list. Supports setting a title, notes, due date, and completion status. Optionally position the task under a parent (as a subtask) or after a specific sibling task.

Delete Task

Permanently delete a task from a task list. This action cannot be undone.