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.
Tools (18)
Googletasks Batch Execute
Googletasks Batch ExecuteIntegration 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.
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
Googletasks Bulk Insert TasksIntegration 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.
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
Googletasks Clear TasksIntegration 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.
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
Googletasks Create Task ListIntegration 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.
tasklist_title
string
✅
"Work Projects"
Title for the new task list. The maximum allowed length is 1024 characters.
Googletasks Delete Task
Googletasks Delete TaskIntegration 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.
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
Googletasks Delete Task ListIntegration 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.
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
Googletasks Get TaskIntegration 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.
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
Googletasks Get Task ListIntegration 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.
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
Googletasks Insert TaskIntegration 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.
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
Googletasks List All TasksIntegration 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.
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
Googletasks List Task ListsIntegration 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.
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
Googletasks List TasksIntegration 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.
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
Googletasks Move TaskIntegration 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
previousparameter)Create subtasks by moving a task under a parent (use
parentparameter)Move tasks between different task lists (use
destinationTasklistparameter)Move a subtask back to top-level (omit
parentparameter)
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
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
Googletasks Patch TaskIntegration 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.
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
Googletasks Patch Task ListIntegration 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.
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
Googletasks Update TaskIntegration 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.
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
Googletasks Update Task FullIntegration 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.
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
Googletasks Update Task ListIntegration 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.
title
string
✅
"New Task List Title"
Title of the task list. Maximum length allowed: 1024 characters.
tasklist_id
string
✅
"MDQ1NTE1OTM4NDM5MzM2MTQ4NzM6MDow"
Task list identifier.
Last updated