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.
With the Google Tasks integration in Sim, you can:
- Create tasks: Add new to-do items to any task list with titles, notes, and due dates
- List tasks: Retrieve all tasks from a specific task list
- Get task details: Fetch detailed information about a specific task by ID
- Update tasks: Modify task titles, notes, due dates, or completion status
- Delete tasks: Remove tasks from a task list
- List task lists: Browse all available task lists in a Google account
In Sim, the Google Tasks integration allows your agents to manage to-do items programmatically as part of automated workflows. This enables use cases such as automated task creation from incoming data, deadline monitoring, and workflow-triggered task management.
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 |