googleapis.com

•

One-click Login

About Google Tasks

The Google Tasks API is a free REST API within Google Workspace that allows developers to create, read, update, and delete task lists and individual tasks. Tasks sync in real time across Gmail, Google Calendar, and mobile apps. As of April 2026, the API also supports reading and editing tasks assigned from Google Docs and Chat Spaces. It is used by developers building productivity integrations on top of the Google ecosystem.

AI Agent Use Cases

- Full CRUD for task lists and tasks via REST

- Real-time sync across Gmail, Calendar, and mobile

- Read/edit tasks assigned from Google Docs and Chat Spaces (added April 2026)

- Due dates, notes, and completion status on tasks

- Standard OAuth2 authentication via Google Workspace

- Free with standard Google Cloud quota limits

Available Actions

These are the specific actions that AI agents can perform with this tool

Create Task

5 inputs

Creates a new task in the specified task list of the authenticated user's Google Tasks account

Inputs

taskListId

The ID of the task list.

title

The title of the task.

notes

The description of the task.

completed

Mark as `true` if your task is already completed.

due

Due date of the task (as a [RFC 3339](https://en.wikipedia.org/wiki/ISO_8601) timestamp). Optional. The due date only records date information; the time portion of the timestamp is discarded when setting the due date. It isn

Create Task List

1 input

Creates a new task list in the authenticated user's Google Tasks account.

Inputs

title

The title of the task list.

Delete Task

2 inputs

Removes a specified task from the authenticated user's Google Tasks list.

Inputs

taskListId

The ID of the task list.

taskId

The ID of the task.

Delete Task List

1 input

Deletes a specified task list from the authenticated user's Google Tasks account.

Inputs

taskListId

The ID of the task list.

List Task Lists

1 input

Retrieves a list of all task lists associated with the authenticated user's Google Tasks account.

Inputs

maxResults

Maximum number of registers to be fetched.

List Tasks

4 inputs

Retrieves all tasks contained within a specified Google Tasks task list.

Inputs

taskListId

The ID of the task list.

maxResults

Maximum number of registers to be fetched.

showCompleted

Whether completed tasks are returned in the result. Defaults to `true`.

showDeleted

Whether deleted tasks are returned in the result. Defaults to `false`.

Update Task

6 inputs

Updates the details of a specified task in the authenticated user's Google Tasks list.

Inputs

taskListId

The ID of the task list.

taskId

The ID of the task.

title

The title of the task.

notes

The description of the task.

completed

Mark as `true` if your task is already completed.

due

Update Task List

2 inputs

Updates the properties of a specified Google Tasks task list for the authenticated user.

Inputs

taskListId

The ID of the task list.

title

The title of the task list.