Googletasks | Composio Docs

Overview

SLUG

GOOGLETASKS

Description

Google Tasks provides a simple to-do list and task management system integrated into Gmail and Google Calendar for quick and easy tracking

Authentication Details

OAuth2

client_id

stringRequired

client_secret

stringRequired

oauth_redirect_uri

stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add

scopes

stringDefaults to https://www.googleapis.com/auth/tasks

bearer_token

string

Tools

Clear tasks

SLUG: GOOGLETASKS_CLEAR_TASKS

Permanently clears all completed tasks from a specified google tasks list; this action is destructive and idempotent.

Action Parameters

tasklist

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create a task list

SLUG: GOOGLETASKS_CREATE_TASK_LIST

Creates a new task list with the specified title.

Action Parameters

tasklist_title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete task

SLUG: GOOGLETASKS_DELETE_TASK

Deletes a specified task from a given task list in google tasks.

Action Parameters

task_id

stringRequired

tasklist_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete task list

SLUG: GOOGLETASKS_DELETE_TASK_LIST

Permanently deletes an existing google task list, identified by `tasklist id`, along with all its tasks; this operation is irreversible.

Action Parameters

tasklist_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get Task

SLUG: GOOGLETASKS_GET_TASK

Use to retrieve a specific google task if its `task id` and parent `tasklist id` are known.

Action Parameters

task_id

stringRequired

tasklist_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get task list

SLUG: GOOGLETASKS_GET_TASK_LIST

Retrieves a specific task list from the user's google tasks if the `tasklist id` exists for the authenticated user.

Action Parameters

tasklist_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Insert Task

SLUG: GOOGLETASKS_INSERT_TASK

Creates a new task in a given `tasklist id`, optionally as a subtask of an existing `task parent` or positioned after an existing `task previous` sibling, where both `task parent` and `task previous` must belong to the same `tasklist id` if specified.

Action Parameters

completed

string

deleted

boolean

due

string

etag

string

hidden

boolean

string

notes

string

status

stringRequired

task_parent

string

task_previous

string

tasklist_id

stringRequired

title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

List Tasks

SLUG: GOOGLETASKS_LIST_TASKS

Retrieves tasks from a google tasks list; all date/time strings must be rfc3339 utc, and `showcompleted` must be true if `completedmin` or `completedmax` are specified.

Action Parameters

completedMax

string

completedMin

string

dueMax

string

dueMin

string

maxResults

integer

pageToken

string

showCompleted

boolean

showDeleted

boolean

showHidden

boolean

tasklist_id

stringRequired

updatedMin

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

List task lists

SLUG: GOOGLETASKS_LIST_TASK_LISTS

Fetches the authenticated user's task lists from google tasks; results may be paginated.

Action Parameters

maxResults

integerDefaults to 20

pageToken

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Move Task

SLUG: GOOGLETASKS_MOVE_TASK

Moves the specified task to another position in the destination task list.

Action Parameters

destinationTasklist

string

parent

string

task

stringRequired

tasklist

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Patch Task

SLUG: GOOGLETASKS_PATCH_TASK

Partially updates an existing task (identified by `task id`) within a specific google task list (identified by `tasklist id`), modifying only the provided attributes from `taskinput` (e.g., `title`, `notes`, `due` date, `status`) and requiring both the task and list to exist.

Action Parameters

completed

string

deleted

boolean

due

string

etag

string

hidden

boolean

string

notes

string

status

stringRequired

task_id

stringRequired

tasklist_id

stringRequired

title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Patch task list

SLUG: GOOGLETASKS_PATCH_TASK_LIST

Updates the title of an existing google tasks task list.

Action Parameters

tasklist_id

stringRequired

updated_title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update Task

SLUG: GOOGLETASKS_UPDATE_TASK

Updates the specified task.

Action Parameters

due

string

notes

string

status

string

task

stringRequired

tasklist

stringRequired

title

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update Task List

SLUG: GOOGLETASKS_UPDATE_TASK_LIST

Updates the authenticated user's specified task list.

Action Parameters

tasklist_id

stringRequired

title

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired