> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Tasks

> Connect Google Tasks to your Atako agents — 4 read and 6 write actions.

Let your agents create, read, update and organize tasks and task lists via the Google Tasks API.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via Google Tasks's consent screen; no key to copy.
* **Scopes requested**:
  * `https://www.googleapis.com/auth/tasks`

See [Google Tasks's documentation](https://developers.google.com/workspace/tasks/reference/rest).

## Read actions (4)

| Action            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_task`        | Get a single task by its task identifier within a task list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `get_task_list`   | Get a single task list by its tasklist identifier.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `list_task_lists` | List all task lists for the authenticated user. maxResults (integer, optional, default 1000, max 1000): max number of lists per page. pageToken (string, optional): token for the next page.                                                                                                                                                                                                                                                                                                                                                                      |
| `list_tasks`      | List tasks in a task list. tasklist (string, required): the task list identifier. showCompleted (boolean, optional, default true): include completed tasks. showHidden (boolean, optional, default false): include hidden tasks. dueMin / dueMax (string, optional): RFC 3339 timestamp bounds for the due date filter. completedMin / completedMax (string, optional): RFC 3339 timestamp bounds for the completion date filter. maxResults (integer, optional, default 20, max 100): max tasks per page. pageToken (string, optional): token for the next page. |

## Write actions (6)

| Action             | Description                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `complete_task`    | Mark a task as completed. tasklist (string, required): the task list identifier. task (string, required): the task identifier. Sets status to "completed".                                                                                                                                                                                                                                                                          |
| `create_task`      | Create a new task in a task list. tasklist (string, required): the task list identifier. title (string, required): the task title (max 1024 chars). notes (string, optional): task notes (max 8192 chars). due (string, optional): due date as YYYY-MM-DD (converted to RFC 3339 internally). parent (string, optional): parent task identifier for subtasks. previous (string, optional): sibling task identifier to insert after. |
| `create_task_list` | Create a new task list. title (string, required): the name of the new task list. Max 1024 characters.                                                                                                                                                                                                                                                                                                                               |
| `move_task`        | Move a task to another position or parent in the task list. tasklist (string, required): the task list identifier. task (string, required): the task identifier. parent (string, optional): new parent task identifier (omit for top level). previous (string, optional): new previous sibling task identifier (omit for first position).                                                                                           |
| `rename_task_list` | Rename a task list. tasklist (string, required): the task list identifier. title (string, required): the new name of the task list.                                                                                                                                                                                                                                                                                                 |
| `update_task`      | Update a task. tasklist (string, required): the task list identifier. task (string, required): the task identifier. title (string, optional): new title. notes (string, optional): new notes. due (string, optional): new due date as YYYY-MM-DD. status (string, optional): "needsAction" or "completed".                                                                                                                          |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*
