Google Tasks

Get current time

Return the current wall-clock time. Use this when reasoning about elapsed time (e.g. current minute of a live match, time until a deadline) or about what day it is — don't guess the time or the date. By default `now_iso` and `local_date` are in the user's own timezone (near midnight the UTC date is a day ahead of the user's local date). Pass `timezone` (an IANA name like 'Europe/Berlin') only to override that, e.g. to read the time in another location.

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.

Create recurring task

Add a repeating task. The Google Tasks API has no native recurrence, so there is nothing to repeat server-side: this materializes the series up front as N independent tasks, one per occurrence, each with its own due date. Give a freq (daily/weekly/monthly/yearly), a start date, and EITHER a count of occurrences OR an until end date; interval repeats every N periods (interval 2 + weekly = biweekly). Due dates are date-only like every other task here (no time of day). Tell the user these are separate tasks that will not regenerate once they run out; for a true self-repeating reminder, suggest their calendar agent. Capped at 50 occurrences per call.

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.