Show every Google Tasks list on the account, with a short alias and the real id. Either can be passed as list_id to the other tools.

List tasks, optionally from one list and/or within a due-date range. Omit list_id to cover every list. Due dates are calendar dates (YYYY-MM-DD): the Google Tasks API cannot store or return a due time.

Find tasks whose title or notes contain the query, across every list. Case-insensitive substring match — the Google Tasks API has no search endpoint, so this filters client-side. Use it to locate a task before acting on it.

Full detail for one task, including notes, links and subtask parent.

Add a task. Omit list_id for the default list. due is a calendar date (YYYY-MM-DD); resolve relative dates like "Thursday" yourself before calling. parent_id makes it a subtask; previous_id places it after a given sibling.

Add several tasks at once. Use this instead of repeated create_task calls when the user lists multiple things. Each entry may target a different list.

Change a task's title, notes or due date. Only the fields you pass are touched — this uses patch, so omitting notes leaves existing notes intact. To remove a due date pass clear_due=true; omitting due leaves it unchanged. Cannot change parent or position — use move_task for that.

Mark one or more tasks done. This is the most common write by a wide margin — prefer it over update_task for finishing things. Safe to repeat.

Mark one or more completed tasks as not done again. Safe to repeat.

Reorder a task, make it a subtask, or move it to another list. Note that repeating tasks cannot be moved between lists.

Permanently delete a task. This cannot be undone. If the task looks like an instance of a repeating task, this refuses unless force=true, because deleting one instance through the API can delete the whole series. Prefer complete_tasks for finished work.

Hide every completed task in a list. They remain retrievable with include="all" but disappear from the Google Tasks UI.

Create a new task list.

Permanently delete a task list and every task in it. This cannot be undone. Requires confirm=true.