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.

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

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started