List all Google Tasks lists in the authorized account with their ids and titles. Call this first to learn which list to target.

Create a new, empty task list.

Rename an existing task list.

Permanently delete a task list AND every task in it. Irreversible. Requires confirm=true.

List tasks in a task list, optionally filtered by status and due-date window. Defaults to open (not completed) tasks in the default list. Dates are YYYY-MM-DD.

Fetch a single task by id.

Create one task. due is YYYY-MM-DD and renders as an all-day item on Google Calendar. For several tasks at once use create_tasks.

Change a task's title, notes, due date, or status. Pass due=null or notes=null to clear that field. Only the fields you pass are changed.

Mark a task as completed.

Mark a completed task as not done again.

Reorder a task, nest it under a parent, un-nest it, or move it to another list. Omit parentTaskId to move to top level. Recurring tasks cannot be moved between lists.

Permanently delete a task (and its subtasks). Irreversible.

Hide all completed tasks in a list (same as 'Clear completed' in the Google Tasks UI). They stay retrievable with list_tasks status=completed but disappear from the default view. Not reversible via the API.

Create up to 100 tasks in one call (e.g. every reading from a syllabus). Each item takes title, optional notes, optional due (YYYY-MM-DD, all-day). With skipIfExists=true (default) an item whose title AND due exactly match an existing open task in the list is skipped, so retrying is safe. Returns a per-item report — check it for partial failures.