Google Tasks
Manage Google Tasks
Google Tasks is Google's lightweight task management service, integrated into Gmail, Google Calendar, and the standalone Google Tasks app. It provides a simple way to create, organize, and track to-do items with support for due dates, subtasks, and task lists. As part of Google Workspace, Google Tasks keeps your action items synchronized across all your devices.
In Sim, the Google Tasks integration allows your agents to create, read, update, delete, and list tasks and task lists as part of automated workflows. This enables use cases such as automated task creation from incoming data, to-do list management based on workflow triggers, task status tracking, and deadline monitoring. By connecting Sim with Google Tasks, your agents can manage action items programmatically, keep teams organized, and ensure nothing falls through the cracks.
Integrate Google Tasks into your workflow. Create, read, update, delete, and list tasks and task lists.
Create a new task in a Google Tasks list
| Parameter | Type | Required | Description |
|---|
taskListId | string | No | Task list ID (defaults to primary task list "@default") |
title | string | Yes | Title of the task (max 1024 characters) |
notes | string | No | Notes/description for the task (max 8192 characters) |
due | string | No | Due date in RFC 3339 format (e.g., 2025-06-03T00:00:00.000Z) |
status | string | No | Task status: "needsAction" or "completed" |
parent | string | No | Parent task ID to create this task as a subtask. Omit for top-level tasks. |
previous | string | No | Previous sibling task ID to position after. Omit to place first among siblings. |
| Parameter | Type | Description |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
List all tasks in a Google Tasks list
| Parameter | Type | Required | Description |
|---|
taskListId | string | No | Task list ID (defaults to primary task list "@default") |
maxResults | number | No | Maximum number of tasks to return (default 20, max 100) |
pageToken | string | No | Token for pagination |
showCompleted | boolean | No | Whether to show completed tasks (default true) |
showDeleted | boolean | No | Whether to show deleted tasks (default false) |
showHidden | boolean | No | Whether to show hidden tasks (default false) |
dueMin | string | No | Lower bound for due date filter (RFC 3339 timestamp) |
dueMax | string | No | Upper bound for due date filter (RFC 3339 timestamp) |
completedMin | string | No | Lower bound for task completion date (RFC 3339 timestamp) |
completedMax | string | No | Upper bound for task completion date (RFC 3339 timestamp) |
updatedMin | string | No | Lower bound for last modification time (RFC 3339 timestamp) |
| Parameter | Type | Description |
|---|
tasks | array | List of tasks |
↳ id | string | Task identifier |
↳ title | string | Title of the task |
↳ notes | string | Notes/description for the task |
↳ status | string | Task status: "needsAction" or "completed" |
↳ due | string | Due date (RFC 3339 timestamp) |
↳ completed | string | Completion date (RFC 3339 timestamp) |
↳ updated | string | Last modification time (RFC 3339 timestamp) |
↳ selfLink | string | URL pointing to this task |
↳ webViewLink | string | Link to task in Google Tasks UI |
↳ parent | string | Parent task identifier |
↳ position | string | Position among sibling tasks (string-based ordering) |
↳ hidden | boolean | Whether the task is hidden |
↳ deleted | boolean | Whether the task is deleted |
↳ links | array | Collection of links associated with the task |
↳ type | string | Link type (e.g., "email", "generic", "chat_message") |
↳ description | string | Link description |
↳ link | string | The URL |
nextPageToken | string | Token for retrieving the next page of results |
Retrieve a specific task by ID from a Google Tasks list
| Parameter | Type | Required | Description |
|---|
taskListId | string | No | Task list ID (defaults to primary task list "@default") |
taskId | string | Yes | The ID of the task to retrieve |
| Parameter | Type | Description |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
Update an existing task in a Google Tasks list
| Parameter | Type | Required | Description |
|---|
taskListId | string | No | Task list ID (defaults to primary task list "@default") |
taskId | string | Yes | The ID of the task to update |
title | string | No | New title for the task |
notes | string | No | New notes for the task |
due | string | No | New due date in RFC 3339 format |
status | string | No | New status: "needsAction" or "completed" |
| Parameter | Type | Description |
|---|
id | string | Task ID |
title | string | Task title |
notes | string | Task notes |
status | string | Task status (needsAction or completed) |
due | string | Due date |
updated | string | Last modification time |
selfLink | string | URL for the task |
webViewLink | string | Link to task in Google Tasks UI |
parent | string | Parent task ID |
position | string | Position among sibling tasks |
completed | string | Completion date |
deleted | boolean | Whether the task is deleted |
Delete a task from a Google Tasks list
| Parameter | Type | Required | Description |
|---|
taskListId | string | No | Task list ID (defaults to primary task list "@default") |
taskId | string | Yes | The ID of the task to delete |
| Parameter | Type | Description |
|---|
taskId | string | Deleted task ID |
deleted | boolean | Whether deletion was successful |
Retrieve all task lists for the authenticated user
| Parameter | Type | Required | Description |
|---|
maxResults | number | No | Maximum number of task lists to return (default 20, max 100) |
pageToken | string | No | Token for pagination |
| Parameter | Type | Description |
|---|
taskLists | array | List of task lists |
↳ id | string | Task list identifier |
↳ title | string | Title of the task list |
↳ updated | string | Last modification time (RFC 3339 timestamp) |
↳ selfLink | string | URL pointing to this task list |
nextPageToken | string | Token for retrieving the next page of results |