# Google Tasks Your Toolhouse AI Worker can connect to Google Tasks using 18 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=googletasks). ## Tools (18) ### `Googletasks Batch Execute` Integration name: **GOOGLETASKS\_BATCH\_EXECUTE** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------- | | `requests` | array | ✅ | — | Array of sub-requests to execute in this batch. Each sub-request is independent and will return its own result. | | `max_requests` | integer | | — | Maximum number of sub-requests allowed in a single batch. Google's typical cap is 1000. Lower values can control response size. | *** ### `Googletasks Bulk Insert Tasks` Integration name: **GOOGLETASKS\_BULK\_INSERT\_TASKS** 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). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | | `tasks` | array | ✅ | — | Array of tasks to create. Each task requires at least a title. | | `batch_size` | integer | | — | Maximum number of tasks per batch request. Default: 50. Tasks exceeding this will be split into multiple batch calls. | | `tasklist_id` | string | ✅ | `"MDQ1NTEzMjc4OTM5MzM0NTY4NzE6MDow"` | Identifier for the Google Task list where tasks will be created. Use actual task list IDs, not '@default'. | *** ### `Googletasks Clear Tasks` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tasklist` | string | ✅ | `"@default"` | 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. | *** ### `Googletasks Create Task List` Integration name: **GOOGLETASKS\_CREATE\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------------- | ------ | :------: | ----------------- | --------------------------------------------------------------------------- | | `tasklist_title` | string | ✅ | `"Work Projects"` | Title for the new task list. The maximum allowed length is 1024 characters. | *** ### `Googletasks Delete Task` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `task_id` | string | ✅ | `"dGFzazoxMjM0NTY3ODkw"` | 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. | | `tasklist_id` | string | ✅ | `"MDQ1NTEzMjc4OTM5MzM0NTY4NzE6MDow"` | 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. | *** ### `Googletasks Delete Task List` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------ | ---------------------------------------------------------------------------------------------------- | | `tasklist_id` | string | ✅ | `"MDQ1MDM5NzY1MzA4NDM4MTIzNDE6MDow"` | Unique identifier of the Google Task list to be deleted. This field is required and cannot be empty. | *** ### `Googletasks Get Task` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `task_id` | string | ✅ | `"MVFfNEN3QUhUSmpZRVk0RQ"` | REQUIRED. Unique identifier of the Google Task to retrieve. Must be used together with tasklist\_id. | | `tasklist_id` | string | ✅ | `"MDQ1NDcwMTQ0OTQ3MTA4MTQ4MTg6MDow"` | 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. | *** ### `Googletasks Get Task List` Integration name: **GOOGLETASKS\_GET\_TASK\_LIST** Retrieves a specific task list from the user's Google Tasks if the `tasklist_id` exists for the authenticated user. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ---------------------------------------- | ------------------------------------------------------------------------------------------------------ | | `tasklist_id` | string | ✅ | `"7f574d94-ae28-4f2e-a69a-fb37978ec62e"` | The unique identifier of the task list to retrieve, assigned by Google Tasks when the list is created. | *** ### `Googletasks Insert Task` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | | — | Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks. | | `due` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `etag` | string | | — | ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API. | | `notes` | 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' | | `title` | string | ✅ | — | Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. Example: 'Complete quarterly report' | | `hidden` | 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 | | `status` | string | | — | Status of the task. Must be either 'needsAction' (task is pending) or 'completed' (task is done). Defaults to 'needsAction' if not provided. | | `deleted` | boolean | | — | Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false | | `completed` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `task_parent` | string | | — | Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list. | | `tasklist_id` | string | ✅ | `"@default"` | 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'). | | `task_previous` | string | | — | Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling). | *** ### `Googletasks List All Tasks` Integration name: **GOOGLETASKS\_LIST\_ALL\_TASKS** 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------- | :------: | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dueMax` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `dueMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `showHidden` | boolean | | — | Include hidden tasks in results. Defaults to false. | | `updatedMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `showDeleted` | boolean | | — | Include deleted tasks in results. Defaults to false. | | `completedMax` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `completedMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `showAssigned` | boolean | | — | Include tasks assigned to the current user in results. Defaults to false. | | `showCompleted` | boolean | | — | Include completed tasks in results. Defaults to true. | | `max_tasks_total` | integer | | — | Hard limit on total number of tasks returned across all lists to prevent large payloads. Defaults to 1000. | *** ### `Googletasks List Task Lists` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `pageToken` | string | | — | Token for the page of results to return; omit for the first page, use `nextPageToken` from a previous response for subsequent pages. | | `maxResults` | integer | | `"10"` | Maximum number of task lists to return per page. Capped at 100; values above 100 are silently truncated to 100. | *** ### `Googletasks List Tasks` Integration name: **GOOGLETASKS\_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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------- | :------: | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `dueMax` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `dueMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `pageToken` | string | | `"CiAKGjBpbmRXUTA1Y1cxVWF6b2hVbkprZWxTelNVUWdRMBoOCL2q0qcCELqGmgsQ0KG3jAE="` | Token from a previous list operation for fetching a specific page; if omitted, retrieves the first page. | | `maxResults` | integer | | `"20"` | 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. | | `showHidden` | boolean | | — | Include hidden tasks. Defaults to false. | | `tasklistId` | string | ✅ | `"@default"` | Identifier of the task list. IMPORTANT: For the user's primary/default task list, you MUST use the literal string '@default' (NOT 'primary', 'default', or any other variation). The value 'primary' is NOT valid and will be rejected by the API. Either use '@default' for the primary list or provide a valid task list ID obtained from list\_task\_lists. | | `updatedMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `showDeleted` | boolean | | — | Include deleted tasks. Defaults to false. | | `completedMax` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `completedMin` | string | | `"2025-09-28T23:59:00Z"` | 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. | | `showCompleted` | boolean | | — | Include completed tasks. Defaults to true. (See action docstring for interaction with `completedMin`/`Max`). | *** ### `Googletasks Move Task` Integration name: **GOOGLETASKS\_MOVE\_TASK** Moves 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) #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------------- | ------ | :------: | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `task` | string | ✅ | `"UXViX2VqVlBJaWJ3bEw1ag"` | 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. | | `parent` | string | | `"newParentTaskId1"` | 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. | | `previous` | string | | `"previousTaskId1"` | 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. | | `tasklist` | string | ✅ | `"@default"` | 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. | | `destinationTasklist` | string | | `"destinationTaskListId1"` | 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. | *** ### `Googletasks Patch Task` Integration name: **GOOGLETASKS\_PATCH\_TASK** Partially 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | | — | Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks. | | `due` | 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. | | `etag` | string | | — | ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API. | | `notes` | 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' | | `title` | string | | — | Title/name of the task. This is the main text displayed for the task. Maximum 1024 characters. Example: 'Complete quarterly report' | | `hidden` | 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 | | `status` | string | | — | Current status of the task. Must be either 'needsAction' (task is pending) or 'completed' (task is done). | | `deleted` | boolean | | — | Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false | | `task_id` | string | ✅ | `"MDQ1NzM3ODI0NzM2NzY0NjA4MDk6MTU4MzM3MDQ4OTow"` | Identifier of the Google Task to be updated within the specified task list. | | `completed` | 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. | | `tasklist_id` | string | ✅ | `"MDQ1NzM3ODI0NzM2NzY0NjA4MDk6MDow"` | Identifier of the Google Task list that contains the task to be updated. | *** ### `Googletasks Patch Task List` Integration name: **GOOGLETASKS\_PATCH\_TASK\_LIST** Updates the title of an existing Google Tasks task list. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | --------------- | ------ | :------: | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `tasklist_id` | string | ✅ | `"MDQ1MjA4MTA5NzQxNzYxMjM0NTY6MDow"` | The unique identifier of the task list to be updated. | | `updated_title` | string | | `"Project Alpha Tasks Q3"` | The new title for the task list. Optional for PATCH semantics - only include if you want to update the title. Maximum length: 1024 characters. | *** ### `Googletasks Update Task` Integration name: **GOOGLETASKS\_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. Prefer GOOGLETASKS\_PATCH\_TASK unless a complete field replacement is explicitly required. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `due` | string | | — | Due date of the task (RFC 3339 timestamp). | | `notes` | string | | — | Notes describing the task. | | `title` | string | | — | Title of the task. | | `status` | 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. | | `task_id` | string | ✅ | — | Task identifier. | | `completed` | string | | — | Completion date of the task (RFC 3339 timestamp). | | `tasklist_id` | string | ✅ | — | Task list identifier. | *** ### `Googletasks Update Task Full` Integration name: **GOOGLETASKS\_UPDATE\_TASK\_FULL** Tool 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. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------- | :------: | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | string | ✅ | — | Task identifier (REQUIRED). Must match the task\_id parameter. This field is required by the Google Tasks API for PUT operations. | | `due` | 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'. | | `etag` | string | | — | ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. | | `links` | array | | — | Collection of links attached to the task. This collection is read-only. | | `notes` | string | | — | Additional details or description for the task. Supports plain text only. Maximum 8192 characters. | | `title` | string | ✅ | — | Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. | | `hidden` | boolean | | — | Whether the task is hidden. This is read-only and set by the API when task list is cleared. Default: false | | `parent` | string | | — | Parent task identifier for subtasks. This field is read-only. Use the 'move' method to change parent. | | `status` | string | | — | Current status of the task. Must be either 'needsAction' (task is pending) or 'completed' (task is done). | | `deleted` | boolean | | — | Whether the task has been deleted. Deleted tasks are marked but not immediately removed. Default: false | | `task_id` | string | ✅ | `"MDQ1NzM3ODI0NzM2NzY0NjA4MDk6MTU4MzM3MDQ4OTow"` | 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. | | `position` | string | | — | Position of the task among siblings. This field is read-only. Use the 'move' method to change position. | | `completed` | 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. | | `tasklist_id` | string | ✅ | `"MDQ1NzM3ODI0NzM2NzY0NjA4MDk6MDow"` | Identifier of the Google Task list that contains the task to be updated. | *** ### `Googletasks Update Task List` Integration name: **GOOGLETASKS\_UPDATE\_TASK\_LIST** Updates the authenticated user's specified task list. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | ------------------------------------ | ---------------------------------------------------------------- | | `title` | string | ✅ | `"New Task List Title"` | Title of the task list. Maximum length allowed: 1024 characters. | | `tasklist_id` | string | ✅ | `"MDQ1NTE1OTM4NDM5MzM2MTQ4NzM6MDow"` | Task list identifier. | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/google-tasks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.