Productivity

Google Tasks

Create, update and complete Google Tasks and manage task lists.

What you can build

Create tasks from emails, issues, or project observations
Mark tasks complete and clear finished items on a schedule
Sync a task list to a sheet or report
Track follow-ups with due dates and notes

Access and credentials

Read, create, update, complete, and delete Google Tasks and task lists via OAuth. Reads retrieve data; creates, updates, and deletes are mutating.

This plugin declares OAuth access. Provider permissions and connection setup must be reviewed when a compatible release is installed.

Example action

Find your task lists

Use this call in a saved OrgSDK action after enabling the plugin and connecting a credential.

return await googleTasks.listTaskLists();

Use with OrgSDK

OrgSDK gives external AI clients persistent projects and controlled execution. Plugins add optional tools to those projects. Each run uses pinned plugin versions, and project configuration determines which credentials they can use.

Set up OrgSDK locally ↗

The plugin’s toolkit

Capabilities

11 functions from this published version. Read calls retrieve or process information; write actions can change data in the connected service.

Find a function

11 of 11 functions

`googleTasks.listTaskLists`

Read call

List all Google Task lists for the authenticated user.

Parameters and return value

This call takes no parameters.

Returns Promise<Array<{ id: string; title: string; updated?: string }>>

`googleTasks.createTaskList`

Tool

Create a new Google Task list.

Parameters and return value

Parameter	Type	Details
`title`	`string`	—

Returns Promise<{ id: string; title: string; updated?: string }>

`googleTasks.deleteTaskList`

Tool

Delete a Google Task list by ID.

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—

Returns Promise<{ success: boolean }>

`googleTasks.listTasks`

Read call

List tasks in a Google Task list. Options: showCompleted (default true), showHidden, dueMin/dueMax (RFC 3339), maxResults (default 100).

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`options`	`{ showCompleted?: boolean; showHidden?: boolean; dueMin?: string; dueMax?: string; maxResults?: number }`	—

Returns Promise<Array<{ id: string; title: string; status: string; notes?: string; due?: string; completed?: string; parent?: string; position?: string; updated?: string }>>

`googleTasks.getTask`

Read call

Get a single Google Task by ID.

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`taskId`	`string`	—

Returns Promise<{ id: string; title: string; status: string; notes?: string; due?: string; completed?: string; parent?: string; position?: string; updated?: string }>

`googleTasks.createTask`

Tool

Create a task in a Google Task list. Options: notes, due (RFC 3339 date string), parent (task ID for subtasks).

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`title`	`string`	—
`options`	`{ notes?: string; due?: string; parent?: string }`	—

Returns Promise<{ id: string; title: string; status: string; notes?: string; due?: string; parent?: string; position?: string; updated?: string }>

`googleTasks.updateTask`

Tool

Update a Google Task. Pass an updates object with any of: title, notes, due (RFC 3339), status ("needsAction" or "completed").

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`taskId`	`string`	—
`updates`	`{ title?: string; notes?: string; due?: string; status?: "needsAction" \| "completed" }`	—

Returns Promise<{ id: string; title: string; status: string; notes?: string; due?: string; completed?: string; parent?: string; position?: string; updated?: string }>

`googleTasks.completeTask`

Tool

Mark a Google Task as completed (sets status to "completed").

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`taskId`	`string`	—

Returns Promise<{ id: string; title: string; status: string; notes?: string; due?: string; completed?: string; parent?: string; position?: string; updated?: string }>

`googleTasks.uncompleteTask`

Tool

Mark a Google Task as incomplete (sets status back to "needsAction").

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`taskId`	`string`	—

Returns Promise<{ id: string; title: string; status: string; notes?: string; due?: string; completed?: string; parent?: string; position?: string; updated?: string }>

`googleTasks.deleteTask`

Tool

Delete a Google Task by ID.

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—
`taskId`	`string`	—

Returns Promise<{ success: boolean }>

`googleTasks.clearCompletedTasks`

Tool

Clear all completed tasks from a Google Task list.

Parameters and return value

Parameter	Type	Details
`taskListId`	`string`	—

Returns Promise<{ success: boolean }>