- Category: task management
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 18
- Triggers: 5
- Slug:
GOOGLETASKS - Version: 20261101_00
Frequently Asked Questions
How do I set up custom Google OAuth credentials for Google Tasks?
How do I set up custom Google OAuth credentials for Google Tasks?
Why am I seeing "App is blocked" when connecting Google Tasks?
Why am I seeing "App is blocked" when connecting Google Tasks?
Why am I getting "Google Tasks API has not been used in project" error?
Why am I getting "Google Tasks API has not been used in project" error?
Why am I getting "Error 400: invalid_scope"?
Why am I getting "Error 400: invalid_scope"?
Why does the OAuth consent screen show "Composio" instead of my app?
Why does the OAuth consent screen show "Composio" instead of my app?
Why am I getting 401 errors on tool calls?
Why am I getting 401 errors on tool calls?
Why am I getting "Quota Exhausted" or "rate limit exhausted"?
Why am I getting "Quota Exhausted" or "rate limit exhausted"?
Tools
Batch Execute Google Tasks Operations
Batch Execute Google Tasks Operations
GOOGLETASKS_BATCH_EXECUTEExecutes 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.Input Parameters
Output
Bulk Insert Tasks (Deprecated)
Bulk Insert Tasks (Deprecated)
GOOGLETASKS_BULK_INSERT_TASKSDEPRECATED: 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).Input Parameters
Output
Clear tasks
Clear tasks
GOOGLETASKS_CLEAR_TASKSPermanently 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.Input Parameters
Output
Create a task list
Create a task list
Delete task
Delete task
GOOGLETASKS_DELETE_TASKDeletes 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.Input Parameters
Output
Delete task list
Delete task list
GOOGLETASKS_DELETE_TASK_LISTPermanently 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.Input Parameters
Output
Get Task
Get Task
GOOGLETASKS_GET_TASKRetrieve 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.Input Parameters
Output
Get task list
Get task list
Insert Task
Insert Task
GOOGLETASKS_INSERT_TASKCreates a task in a specified list, optionally under a parent or after a sibling in that list. Date inputs accept various formats; due dates are normalized to midnight UTC, discarding the time, and repeated calls can create duplicate tasks.Input Parameters
Output
List All Tasks Across All Lists
List All Tasks Across All Lists
GOOGLETASKS_LIST_ALL_TASKSList tasks across the user’s task lists with optional filters, annotating each returned task with its list ID and title. Results are limited to 1,000 tasks by default, with a configurable limit and a truncation indicator.Input Parameters
Output
List task lists
List task lists
GOOGLETASKS_LIST_TASK_LISTSFetches 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.Input Parameters
nextPageToken from a previous response for subsequent pages.Output
List Tasks
List Tasks
GOOGLETASKS_LIST_TASKSRetrieves tasks from a Google Tasks list with optional date, status, and pagination filters; date inputs can use human-readable formats, and a completion range forces an explicit false showCompleted value to true. Tasks are returned under tasks, ordered by position; filter titles or notes client-side for text search.Input Parameters
nextPageToken from the response in successive calls until absent to avoid missing tasks beyond the first page.completedMin/Max).Output
Move Task
Move Task
GOOGLETASKS_MOVE_TASKMoves the specified task to another position in the task list or to a different task list. Use cases: - Reorder tasks within a list (use ‘previous’ parameter) - Create subtasks by moving a task under a parent (use ‘parent’ parameter) - Move tasks between different task lists (use ‘destinationTasklist’ parameter) - Move a subtask back to top-level (omit ‘parent’ parameter)Input Parameters
Output
Patch Task
Patch Task
GOOGLETASKS_PATCH_TASKPartially updates an existing task (identified by task_id) within a specific Google Task list (identified by tasklist_id), modifying only the provided attributes from TaskInput (e.g., title, notes, due date, status) and requiring both the task and list to exist.Input Parameters
Output
Patch task list
Patch task list
Update Task (Deprecated)
Update Task (Deprecated)
GOOGLETASKS_UPDATE_TASKDeprecated: Updates a Google task with the supplied fields. When marked completed without an explicit completion timestamp, it sets the timestamp to the current time.Input Parameters
Output
Update Task (Full Replacement)
Update Task (Full Replacement)
GOOGLETASKS_UPDATE_TASK_FULLTool to fully replace an existing Google Task using PUT method. Use when you need to update the entire task resource, not just specific fields. This method requires all required fields (id, title) and replaces the complete task, unlike PATCH which supports partial updates.Input Parameters
Output
Triggers
New Task Created
New Task Created
GOOGLETASKS_NEW_TASK_CREATED_TRIGGERType: pollTriggers when a new task is created in a Google Tasks list. Uses timestamp filtering (updatedMin) to efficiently detect new tasks.Configuration
Payload
New Task List Created
New Task List Created
Task Details Changed
Task Details Changed
Task List Changed
Task List Changed
GOOGLETASKS_TASK_LIST_CHANGED_TRIGGERType: pollTriggers when a task list changes (title or content updates). This trigger monitors a specific Google Tasks list and fires when changes are detected.Configuration
Payload
Task Updated
Task Updated
GOOGLETASKS_TASK_UPDATED_TRIGGERType: pollTriggers when an existing task is updated in a Google Tasks list. This trigger monitors a specific task list and fires when tasks are modified.