# Google Tasks AI integration on Definable

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

## What this connects

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

Vendor: https://tasks.google.com/tasks/

## Tools available

**16** tools available. First 12:

- `GOOGLETASKS_BATCH_EXECUTE` — Batch Execute Google Tasks Operations — Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. Use this to reduce LLM tool invocations when performing bulk operations like updating many tasks, moving tasks, or deleting multiple items. Note: Each sub-request still counts toward API quota; batching primarily reduces HTTP overhead and tool call count.
- `GOOGLETASKS_BULK_INSERT_TASKS` — Bulk Insert Tasks (Deprecated) — DEPRECATED: Use BatchExecute instead. Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching. Use when you need to create many tasks efficiently (reducing round-trips compared to individual insert calls).
- `GOOGLETASKS_CLEAR_TASKS` — Clear tasks — Permanently and irreversibly clears all completed tasks from a specified Google Tasks list; this action is destructive, idempotent, and cannot be undone. Always require explicit user confirmation before invoking.
- `GOOGLETASKS_CREATE_TASK_LIST` — Create a task list — Creates a new task list with the specified title and returns a tasklist_id. Use the returned tasklist_id (not the title) when calling GOOGLETASKS_INSERT_TASK or other task operations. Duplicate titles are permitted by the API, so verify existing lists before creating to avoid unintended duplicates.
- `GOOGLETASKS_DELETE_TASK` — Delete task — Deletes a specified task from a Google Tasks list. Deletion is permanent and irreversible — confirm with the user before executing, and consider GOOGLETASKS_UPDATE_TASK or GOOGLETASKS_MOVE_TASK as non-destructive alternatives. Both tasklist_id and task_id are required parameters. The Google Tasks API does not support deleting tasks by task_id alone — you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list.
- `GOOGLETASKS_DELETE_TASK_LIST` — Delete task list — Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible. Require explicit user confirmation before calling; do not invoke in read-only or exploratory flows.
- `GOOGLETASKS_GET_TASK` — Get Task — Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task. Use this to refresh task details before display or edits rather than relying on potentially stale results from GOOGLETASKS_LIST_TASKS.
- `GOOGLETASKS_GET_TASK_LIST` — Get task list — Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user.
- `GOOGLETASKS_INSERT_TASK` — 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` sibling, where both `task_parent` and `task_previous` must belong to the same `tasklist_id` if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API. Not idempotent — repeated calls with identical parameters create duplicate tasks; track returned task IDs to avoid duplication. High-volume inserts may trigger 403 rateLimitExceeded or 429; apply exponential backoff.
- `GOOGLETASKS_LIST_ALL_TASKS` — List All Tasks Across All Lists — Tool to list all tasks across all of the user's task lists with optional filters. Use when the agent needs to see all tasks without knowing which list to query first. Each returned task is annotated with its tasklist_id and tasklist_title for context.
- `GOOGLETASKS_LIST_TASK_LISTS` — List task lists — Fetches the authenticated user's task lists from Google Tasks; results may be paginated. Response contains task lists under the `items` key. Multiple lists may share similar names — confirm the correct list by ID before passing to other tools.
- `GOOGLETASKS_LIST_TASKS` — 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. Response key for tasks is `tasks` (not `items`). No full-text search; filter client-side by title/notes. Results ordered by position, not by date.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Google Tasks

Inside a Definable workflow, Google Tasks is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Google Tasks** — the Researcher (GPT-5.5) pulls context from Google Tasks (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Google Tasks** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Google Tasks (create record, post message, draft email).
- **Designer / Engineer → Distributor → Google Tasks** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Google Tasks (attach file, open PR comment, post status).

The Verifier checks every Google Tasks call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- task management — https://definable.ai/apps/category/task-management/

## Related

- HTML page: https://definable.ai/apps/googletasks/
- Same category (task management): https://definable.ai/apps/category/task-management/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt