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.

Usage Instructions

Integrate Google Tasks into your workflow. Create, read, update, delete, and list tasks and task lists.

Tools

google_tasks_create

Create a new task in a Google Tasks list

Input

ParameterTypeRequiredDescription
taskListIdstringNoTask list ID (defaults to primary task list "@default")
titlestringYesTitle of the task (max 1024 characters)
notesstringNoNotes/description for the task (max 8192 characters)
duestringNoDue date in RFC 3339 format (e.g., 2025-06-03T00:00:00.000Z)
statusstringNoTask status: "needsAction" or "completed"
parentstringNoParent task ID to create this task as a subtask. Omit for top-level tasks.
previousstringNoPrevious sibling task ID to position after. Omit to place first among siblings.

Output

ParameterTypeDescription
idstringTask ID
titlestringTask title
notesstringTask notes
statusstringTask status (needsAction or completed)
duestringDue date
updatedstringLast modification time
selfLinkstringURL for the task
webViewLinkstringLink to task in Google Tasks UI
parentstringParent task ID
positionstringPosition among sibling tasks
completedstringCompletion date
deletedbooleanWhether the task is deleted

google_tasks_list

List all tasks in a Google Tasks list

Input

ParameterTypeRequiredDescription
taskListIdstringNoTask list ID (defaults to primary task list "@default")
maxResultsnumberNoMaximum number of tasks to return (default 20, max 100)
pageTokenstringNoToken for pagination
showCompletedbooleanNoWhether to show completed tasks (default true)
showDeletedbooleanNoWhether to show deleted tasks (default false)
showHiddenbooleanNoWhether to show hidden tasks (default false)
dueMinstringNoLower bound for due date filter (RFC 3339 timestamp)
dueMaxstringNoUpper bound for due date filter (RFC 3339 timestamp)
completedMinstringNoLower bound for task completion date (RFC 3339 timestamp)
completedMaxstringNoUpper bound for task completion date (RFC 3339 timestamp)
updatedMinstringNoLower bound for last modification time (RFC 3339 timestamp)

Output

ParameterTypeDescription
tasksarrayList of tasks
idstringTask identifier
titlestringTitle of the task
notesstringNotes/description for the task
statusstringTask status: "needsAction" or "completed"
duestringDue date (RFC 3339 timestamp)
completedstringCompletion date (RFC 3339 timestamp)
updatedstringLast modification time (RFC 3339 timestamp)
selfLinkstringURL pointing to this task
webViewLinkstringLink to task in Google Tasks UI
parentstringParent task identifier
positionstringPosition among sibling tasks (string-based ordering)
hiddenbooleanWhether the task is hidden
deletedbooleanWhether the task is deleted
linksarrayCollection of links associated with the task
typestringLink type (e.g., "email", "generic", "chat_message")
descriptionstringLink description
linkstringThe URL
nextPageTokenstringToken for retrieving the next page of results

google_tasks_get

Retrieve a specific task by ID from a Google Tasks list

Input

ParameterTypeRequiredDescription
taskListIdstringNoTask list ID (defaults to primary task list "@default")
taskIdstringYesThe ID of the task to retrieve

Output

ParameterTypeDescription
idstringTask ID
titlestringTask title
notesstringTask notes
statusstringTask status (needsAction or completed)
duestringDue date
updatedstringLast modification time
selfLinkstringURL for the task
webViewLinkstringLink to task in Google Tasks UI
parentstringParent task ID
positionstringPosition among sibling tasks
completedstringCompletion date
deletedbooleanWhether the task is deleted

google_tasks_update

Update an existing task in a Google Tasks list

Input

ParameterTypeRequiredDescription
taskListIdstringNoTask list ID (defaults to primary task list "@default")
taskIdstringYesThe ID of the task to update
titlestringNoNew title for the task
notesstringNoNew notes for the task
duestringNoNew due date in RFC 3339 format
statusstringNoNew status: "needsAction" or "completed"

Output

ParameterTypeDescription
idstringTask ID
titlestringTask title
notesstringTask notes
statusstringTask status (needsAction or completed)
duestringDue date
updatedstringLast modification time
selfLinkstringURL for the task
webViewLinkstringLink to task in Google Tasks UI
parentstringParent task ID
positionstringPosition among sibling tasks
completedstringCompletion date
deletedbooleanWhether the task is deleted

google_tasks_delete

Delete a task from a Google Tasks list

Input

ParameterTypeRequiredDescription
taskListIdstringNoTask list ID (defaults to primary task list "@default")
taskIdstringYesThe ID of the task to delete

Output

ParameterTypeDescription
taskIdstringDeleted task ID
deletedbooleanWhether deletion was successful

google_tasks_list_task_lists

Retrieve all task lists for the authenticated user

Input

ParameterTypeRequiredDescription
maxResultsnumberNoMaximum number of task lists to return (default 20, max 100)
pageTokenstringNoToken for pagination

Output

ParameterTypeDescription
taskListsarrayList of task lists
idstringTask list identifier
titlestringTitle of the task list
updatedstringLast modification time (RFC 3339 timestamp)
selfLinkstringURL pointing to this task list
nextPageTokenstringToken for retrieving the next page of results

On this page