Google Tasks

list_task_lists

List every Google Tasks list the user has, with id and title. Use during onboarding to discover list IDs, or at the start of a conversation to resolve friendly list names ('Groceries', 'House', 'Work') into the opaque IDs the write tools need.

list_tasks

List tasks in a single Google Tasks list. Returns title, notes, status, due date, and completion time for each task. Defaults to open (needsAction) tasks only; set show_completed to include recent completions. Always pass an explicit tasklist_id. Use list_task_lists first if you do not have one.

create_task

Create a new task on a specified list. Only title is required; notes are the body. due is an optional RFC3339 timestamp but the Google Tasks API stores only the date portion — never use it for time-of-day reminders. Confirm before creating highly visible tasks the user did not explicitly ask for.

update_task

Update an existing task's title, notes, or due date. Uses PATCH semantics: fields you don't pass are left unchanged. For marking a task done, prefer the dedicated complete_task tool.

complete_task

Mark a task as completed. Sets status to 'completed'; Google Tasks stamps the completion time automatically. Use this instead of update_task when ticking a task off.

delete_task

Permanently delete a task. This is destructive and cannot be undone. Prefer complete_task for routine 'done' cases; only delete when the user explicitly asks to remove a task.

save_google_tasks_profile

Save or update profile notes scoped to the Google Tasks integration. Use for task list IDs, preferred list for quick capture, how the user labels contexts (@home, @errands), and any 'off-limits' lists the agent should never modify. Call get_agent_instructions first.