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

# Google Tasks

> Google Tasks provides a simple to-do list and task management system integrated into Gmail and Google Calendar for quick and easy tracking

Google Tasks provides a simple to-do list and task management system integrated into Gmail and Google Calendar for quick and easy tracking

`googletasks` · **18 tools** · **5 triggers**

## Connect it

```bash theme={"theme":"github-dark"}
run auth googletasks
run auth googletasks --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run googletasks          # common commands
run googletasks --all    # every command
```

```ts theme={"theme":"github-dark"}
import { googletasks } from "@boxd/run";
```

## Common tools

| Tool                | What it does                                                                                                                                              |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `update-task-full`  | Tool to fully replace an existing Google Task using PUT method.                                                                                           |
| `batch-execute`     | Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results.                                     |
| `bulk-insert-tasks` | DEPRECATED: Use BatchExecute instead. Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching.                            |
| `clear-tasks`       | Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. |
| `create-task-list`  | Creates a new task list with the specified title and returns a tasklist\_id.                                                                              |

<Accordion title="All 18 tools" icon="list">
  | Tool                | What it does                                                                                                                                                                 |
  | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `batch-execute`     | Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results.                                                        |
  | `bulk-insert-tasks` | DEPRECATED: Use BatchExecute instead. Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching.                                               |
  | `clear-tasks`       | Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone.                    |
  | `create-task-list`  | Creates a new task list with the specified title and returns a tasklist\_id.                                                                                                 |
  | `delete-task`       | Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible - confirm with the user before executing, and consider...                          |
  | `delete-task-list`  | Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible.                                     |
  | `get-task`          | Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`.                                                                                                  |
  | `get-task-list`     | Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user.                                                          |
  | `insert-task`       | Creates a new task in a given `tasklist_id`, optionally as a subtask of an existing `task_parent` or positioned after an existing `task_previous`...                         |
  | `list-all-tasks`    | Tool to list all tasks across all of the user's task lists with optional filters.                                                                                            |
  | `list-task-lists`   | Fetches the authenticated user's task lists from Google Tasks; results may be paginated.                                                                                     |
  | `list-tasks`        | Retrieves tasks from a Google Tasks list; all date/time strings must be RFC3339 UTC, and `showCompleted` must be true if `completedMin` or `completedMax` are specified.     |
  | `move-task`         | Moves the specified task to another position in the task list or to a different task list.                                                                                   |
  | `patch-task`        | Partially updates an existing task (identified by `task_id`) within a specific Google Task list (identified by `tasklist_id`), modifying only the...                         |
  | `patch-task-list`   | Updates the title of an existing Google Tasks task list.                                                                                                                     |
  | `update-task`       | DEPRECATED: Use GOOGLETASKS\_PATCH\_TASK instead. Full-update (PUT-style) operation that overwrites unspecified fields with empty/default values, which can cause data loss. |
  | `update-task-full`  | Tool to fully replace an existing Google Task using PUT method.                                                                                                              |
  | `update-task-list`  | Updates the authenticated user's specified task list.                                                                                                                        |
</Accordion>

## Triggers (5)

Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument.

| Trigger               | Needs                    | What fires it                                                     |
| --------------------- | ------------------------ | ----------------------------------------------------------------- |
| New Task Created      | nothing                  | Triggers when a new task is created in a Google Tasks list.       |
| New Task List Created | nothing                  | Triggers when a new Google Tasks task list is created.            |
| Task Details Changed  | `tasklist_id`, `task_id` | Triggers when a specific task's details change.                   |
| Task List Changed     | `tasklist_id`            | Triggers when a task list changes (title or content updates).     |
| Task Updated          | nothing                  | Triggers when an existing task is updated in a Google Tasks list. |

[Open Google Tasks in the console →](https://app.boxd.sh/integrations/detail/googletasks)
