Skip to main content
Google Tasks logo
  • Category: task management
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 18
  • Triggers: 5
  • Slug: GOOGLETASKS
  • Version: 20261101_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see How to create OAuth2 credentials for Google Apps.
The OAuth client is requesting scopes that Google hasn’t verified for that client. This usually happens when you add extra scopes beyond the defaults.Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See How to create OAuth2 credentials for Google Apps.
When using custom OAuth credentials, the Google Tasks API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.
The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the Google OAuth scopes docs. If you’re creating auth configs programmatically, see the programmatic auth config guide.
The user’s access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google’s refresh token limit (~50 per account) was exceeded. Re-authenticating the user typically resolves this.
Google enforces per-minute and daily request quotas. If you’re using Composio’s default OAuth app, you share that quota with other users, which can cause limits to be hit faster. Use your own OAuth app credentials to get a dedicated quota, and add exponential backoff and retries to handle transient rate limits.

Tools

Slug: 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

array
required
Array of sub-requests to execute in this batch. Each sub-request is independent and will return its own result.
integer
Maximum number of sub-requests allowed in a single batch. Google’s typical cap is 1000. Lower values can control response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
required
Array of tasks to create. Each task requires at least a title.
integer
Maximum number of tasks per batch request. Default: 50. Tasks exceeding this will be split into multiple batch calls.
string
required
Identifier for the Google Task list where tasks will be created. Use actual task list IDs, not ‘@default’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The identifier of the task list from which to clear completed tasks. Use ‘@default’ (with the @ symbol) for the user’s primary task list, or provide the task list ID obtained from GOOGLETASKS_LIST_TASK_LISTS. Note: ‘default’ without the @ prefix is not valid.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLETASKS_CREATE_TASK_LISTCreates a new task list with the specified title and returns its details, including its ID for use in task operations. Duplicate titles are permitted, so check existing lists before creating one to avoid unintended duplicates.

Input Parameters

string
required
Title for the new task list. The maximum allowed length is 1024 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The unique identifier of the Google Task to delete. Required - must be a task that exists within the specified tasklist_id. Obtain this ID by using the ‘List Tasks’ action with the corresponding tasklist_id. Multiple tasks may share the same title — verify against additional fields (e.g., due date, notes) before selecting the task_id to avoid deleting the wrong task.
string
required
The unique identifier of the Google Task list containing the task to delete. Required - tasks cannot be deleted by task_id alone; the API requires specifying which list contains the task. Obtain this ID by using the ‘List Task Lists’ action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Unique identifier of the Google Task list to be deleted. This field is required and cannot be empty.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
REQUIRED. Unique identifier of the Google Task to retrieve. Must be used together with tasklist_id.
string
required
REQUIRED. Unique identifier of the Google Tasks list containing the task. You must always provide this parameter - tasks cannot be retrieved by task_id alone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLETASKS_GET_TASK_LISTRetrieves a specific task list from the user’s Google Tasks if the tasklist_id exists for the authenticated user.

Input Parameters

string
required
The unique identifier of the task list to retrieve, assigned by Google Tasks when the list is created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks.
string
Due date for the task (optional). NOTE: Google Tasks only stores the date portion (YYYY-MM-DD) - any time component provided will be automatically stripped before sending to the API. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API.
string
Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: ‘Include Q3 sales data and projections’
string
required
Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. Example: ‘Complete quarterly report’
boolean
Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won’t show in UI. Default: false
string ("needsAction" | "completed")
Status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done). Defaults to ‘needsAction’ if not provided.
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list.
string
required
Task list identifier where the new task will be created. Valid values: (1) ‘@default’ - special identifier that references the user’s default/primary task list, or (2) an actual task list ID obtained from the ‘List Task Lists’ action (GOOGLETASKS_LIST_TASK_LISTS). Task list IDs are opaque strings generated by Google (typically base64-encoded, e.g., ‘MDQ1NTEzMjc4OTM5MzM0NTY4NzE6MDow’).
string
Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Only include tasks due on or before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Only include tasks due on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include hidden tasks in results. Defaults to false.
string
Only include tasks updated on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include deleted tasks in results. Defaults to false.
string
Only include tasks completed on or before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Only include tasks completed on or after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include tasks assigned to the current user in results. Defaults to false.
boolean
Include completed tasks in results. Defaults to true.
integer
Hard limit on total number of tasks returned across all lists to prevent large payloads. Defaults to 1000.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Token for the page of results to return; omit for the first page, use nextPageToken from a previous response for subsequent pages.
integer
Maximum number of task lists to return per page. Capped at 100; values above 100 are silently truncated to 100.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Exclude tasks due after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Exclude tasks due before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Token from a previous list operation for fetching a specific page; if omitted, retrieves the first page.
integer
Maximum number of tasks to return. API default: 20, maximum: 100. Use nextPageToken from the response in successive calls until absent to avoid missing tasks beyond the first page.
boolean
Include hidden tasks. Defaults to false.
string
Lower bound for task’s last modification time (for syncing). Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include deleted tasks. Defaults to false.
string
required
Identifier of the task list. Use ‘@default’ for the user’s primary list, or provide a task list ID from GOOGLETASKS_LIST_TASK_LISTS. The common aliases ‘primary’, ‘default’, and ‘@primary’ are normalized to ‘@default’.
string
Exclude tasks completed after this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
string
Exclude tasks completed before this date. Google Tasks API requires dates in RFC3339 format (e.g., 2025-09-22T13:48:27Z). We automatically convert various human-readable formats to RFC3339: Accepted formats: • 2025-09-28T23:59:00Z → RFC3339/ISO-8601 format (preferred) - September 28, 2025 at 11:59 PM UTC • 28 Sep 2025 → Simple date format - Will be converted to midnight UTC on that date • 11:59 PM, 22 Sep 2025 → Time with date - Assumes UTC timezone if not specified • 1:00 PM, 21 Sep 2025 → 12-hour format with date - Converted to 13:00 UTC • UTC-5:30, 6:50 PM → With timezone offset - Converted to UTC automatically • UTC+1, 11:59 PM, 31 Dec → Timezone with date - Next occurrence of Dec 31 • 2025-09-21T15:30:00+02:00 → RFC3339 with timezone offset Note: If no timezone is specified, UTC is assumed. Dates without times default to midnight UTC.
boolean
Include completed tasks. Defaults to true. (See action docstring for interaction with completedMin/Max).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Task identifier of the task to move. Must be a valid task ID from the source tasklist. Obtain this from ‘List Tasks’ or ‘Insert Task’ actions.
string
New parent task identifier. If provided, the task becomes a subtask of this parent. The parent must exist in the destination list (or source list if no destinationTasklist is specified). Omit to move task to top level.
string
New previous sibling task identifier. The task will be positioned immediately after this sibling. Omit to position the task first among its siblings. Must exist in the same list as the task’s destination (destinationTasklist if specified, otherwise source tasklist). Cross-list sibling references are unsupported.
string
required
Source task list identifier where the task currently exists. Use ‘@default’ for the user’s primary task list, or provide a specific task list ID obtained from ‘List Task Lists’. The task must exist in this list.
string
Destination task list identifier. If set, the task is moved from the source tasklist to this list. Omit to reorder within the same list. Note: Recurrent tasks cannot be moved between lists.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks.
string
Due date for the task (optional). NOTE: Google Tasks only stores the date portion (YYYY-MM-DD) - any time component provided will be automatically stripped before sending to the API. Accepts RFC3339 format (e.g., ‘2025-09-28T23:59:00Z’) or various human-readable formats like ‘28 Sep 2025’, ‘11:59 PM, 22 Sep 2025’. Normalized to midnight UTC — naive local dates without timezone offset may shift ±1 day. Time-based reminders are not supported via this field.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API.
string
Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: ‘Include Q3 sales data and projections’
string
Title/name of the task. This is the main text displayed for the task. Maximum 1024 characters. Example: ‘Complete quarterly report’
boolean
Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won’t show in UI. Default: false
string ("needsAction" | "completed")
Current status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done).
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false
string
required
Identifier of the Google Task to be updated within the specified task list.
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Accepts RFC3339 format or human-readable date formats. Malformed or non-RFC3339 values will be rejected.
string
required
Identifier of the Google Task list that contains the task to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLETASKS_PATCH_TASK_LISTUpdates the title of an existing Google Tasks task list.

Input Parameters

string
required
The unique identifier of the task list to be updated.
string
The new title for the task list. Optional for PATCH semantics - only include if you want to update the title. Maximum length: 1024 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Due date of the task (RFC 3339 timestamp).
string
Notes describing the task.
string
Title of the task.
string
Status of the task. Valid values: “needsAction” or “completed”. When setting to “completed”, the completion date will be auto-set to the current time if not explicitly provided via the completed field.
string
required
Task identifier.
string
Completion date of the task (RFC 3339 timestamp).
string
required
Task list identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Task identifier (REQUIRED). Must match the task_id parameter. This field is required by the Google Tasks API for PUT operations.
string
Due date for the task. NOTE: Google Tasks only stores the date portion (YYYY-MM-DD). Accepts RFC3339 format (e.g., ‘2025-09-28T00:00:00Z’) or date strings like ‘2025-09-28’.
string
ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task.
Collection of links attached to the task. This collection is read-only.
string
Additional details or description for the task. Supports plain text only. Maximum 8192 characters.
string
required
Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters.
boolean
Whether the task is hidden. This is read-only and set by the API when task list is cleared. Default: false
string
Parent task identifier for subtasks. This field is read-only. Use the ‘move’ method to change parent.
string ("needsAction" | "completed")
Current status of the task. Must be either ‘needsAction’ (task is pending) or ‘completed’ (task is done).
boolean
Whether the task has been deleted. Deleted tasks are marked but not immediately removed. Default: false
string
required
Identifier of the Google Task to be fully replaced within the specified task list. This must also be included in the ‘id’ field of the request body.
string
Position of the task among siblings. This field is read-only. Use the ‘move’ method to change position.
string
Date/time when the task was marked as completed. Only applicable when status=‘completed’. Unlike ‘due’, this field preserves the time component. Accepts RFC3339 format.
string
required
Identifier of the Google Task list that contains the task to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLETASKS_UPDATE_TASK_LISTUpdates the authenticated user’s specified task list.

Input Parameters

string
required
Title of the task list. Maximum length allowed: 1024 characters.
string
required
Task list identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: 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

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
integer
Maximum number of tasks to check in each poll (1-100)
string
Identifier of the task list to monitor. Use ‘@default’ for the primary task list or provide a specific task list ID from list_task_lists action.

Payload

string
Type of event that occurred
object
required
The newly created task
Slug: GOOGLETASKS_NEW_TASK_LIST_CREATED_TRIGGERType: pollTriggers when a new Google Tasks task list is created. This trigger monitors Google Tasks and fires when new task lists are detected.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
integer
Maximum number of task lists to check in each poll (1-100)

Payload

string
Type of event that occurred
object
required
The newly created task list
Slug: GOOGLETASKS_TASK_DETAILS_CHANGED_TRIGGERType: pollTriggers when a specific task’s details change. This trigger monitors a single Google Task and fires when any of its details (title, notes, status, due date, completion, position) are modified.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
The ID of the specific task to monitor for changes
string
required
The ID of the task list containing the task to monitor

Payload

array
required
List of field names that changed
string
Type of event that occurred
object
The previous task snapshot (None on first poll)
object
required
The current task with all details
Slug: 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

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
string
required
The unique identifier of the task list to monitor for changes. Use ‘@default’ for the default task list.

Payload

array
List of fields that changed (e.g., ‘title’, ‘updated’)
string
Type of event that occurred
object
required
The task list with changed state
Slug: 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.

Configuration

number
Periodic Interval to Check for Updates & Send a Trigger in Minutes
integer
Maximum number of tasks to check in each poll (1-100)
boolean
Include completed tasks in the monitoring. Defaults to true.
boolean
Include deleted tasks in the monitoring. Defaults to false.
string
Identifier of the task list to monitor. Use ‘@default’ for the primary task list, or provide a specific task list ID from list_task_lists action.

Payload

string
Type of event that occurred
object
required
The updated task