Google Tasks

Authentication: OAuth. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.

Sample use cases

List every task on my Work list due this week, sorted by due date.
Add a follow-up task to my Personal list for each unread email starred this morning.
Move every completed task older than 30 days into the Archive list.

list_tasks

List tasks in a Google task list. Supports pagination and filters by completion, due date, or last update. Use…

get_task

Get a task from a Google task list. Use list_tasks to find valid IDs.

create_task

Create a new task on a Google task list. Use parent to create a subtask, and previous to position it after a sibling…

update_task

Update fields on a Google task. Set status to ‘completed’ to mark it done. Use list_tasks to find valid IDs.

delete_task

Delete a task from a Google task list permanently. This cannot be undone. Use list_tasks to find valid IDs.

move_task

Move a task to a new position, parent, or task list. Omit parent and previous to move to the top-level first position…

clear_completed_tasks

Hide all completed tasks from the specified task list. Hidden tasks can still be retrieved by passing show_hidden=true…

list_tasklists

List the authenticated user’s Google task lists. Supports pagination via page_token. A user can have up to 2000 lists.

get_tasklist

Get a Google task list by ID. Use list_tasklists to find valid IDs.

create_tasklist

Create a new Google task list with the given title.

update_tasklist

Update a Google task list’s title. Use list_tasklists to find valid IDs.

delete_tasklist

Delete a Google task list permanently. All tasks inside are also deleted. This cannot be undone. Use list_tasklists to…