Productivity & Project Management

Google Tasks

Learn how to use Google Tasks with Composio

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

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

Connecting to Google Tasks

Create an auth config

Use the dashboard to create an auth config for the Google Tasks toolkit. This allows you to connect multiple Google Tasks accounts to Composio for agents to use.

1

Select App

Navigate to [Google Tasks](https://platform.composio.dev?next_page=/marketplace/Google Tasks).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Google Tasks Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4googletasks_auth_config_id = "ac_YOUR_GOOGLETASKS_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11    connection_request = composio.connected_accounts.initiate(
12        user_id=user_id,
13        auth_config_id=auth_config_id,
14    )
15
16    print(
17        f"Visit this URL to authenticate Google Tasks: {connection_request.redirect_url}"
18    )
19
20    # This will wait for the auth flow to be completed
21    connection_request.wait_for_connection(timeout=15)
22    return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, googletasks_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Google Tasks toolkit’s playground](https://app.composio.dev/app/Google Tasks)

For code examples, see the Tool calling guide and Provider examples.

Tool List

Tool Name: Batch Execute Google Tasks Operations

Description

Executes multiple Google Tasks API operations in a single HTTP batch request and returns structured per-item results. Use this to reduce LLM tool invocations when performing bulk operations like updating many tasks, moving tasks, or deleting multiple items. Note: Each sub-request still counts toward API quota; batching primarily reduces HTTP overhead and tool call count.

Action Parameters

max_requests
integerDefaults to 1000
requests
arrayRequired
validate_paths
booleanDefaults to True

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Bulk Insert Tasks

Description

Creates multiple tasks in a Google Tasks list in a single operation using HTTP batching. Use when you need to create many tasks efficiently (reducing round-trips compared to individual insert calls).

Action Parameters

batch_size
Defaults to 50
tasklist_id
stringRequired
tasks
arrayRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear tasks

Description

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
successful
booleanRequired

Tool Name: Create a task list

Description

Creates a new task list with the specified title.

Action Parameters

tasklist_title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete task

Description

Deletes a specified task from a Google Tasks list. Both tasklist_id and task_id are required parameters. Important: The Google Tasks API does not support deleting tasks by task_id alone - you must specify which task list contains the task. Use 'List Task Lists' to get available list IDs, then 'List Tasks' to find the task_id within that list.

Action Parameters

task_id
stringRequired
tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete task list

Description

Permanently deletes an existing Google Task list, identified by `tasklist_id`, along with all its tasks; this operation is irreversible.

Action Parameters

tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Task

Description

Retrieve a specific Google Task. REQUIRES both `tasklist_id` and `task_id`. Tasks cannot be retrieved by ID alone - you must always specify which task list contains the task.

Action Parameters

task_id
stringRequired
tasklist_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get task list

Description

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
successful
booleanRequired

Tool Name: Insert Task

Description

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. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API.

Action Parameters

completed
deleted
due
etag
hidden
id
notes
status
Defaults to needsAction
task_parent
task_previous
tasklist_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List All Tasks Across All Lists

Description

Tool to list all tasks across all of the user's task lists with optional filters. Use when the agent needs to see all tasks without knowing which list to query first. Each returned task is annotated with its tasklist_id and tasklist_title for context.

Action Parameters

completedMax
completedMin
dueMax
dueMin
max_tasks_total
Defaults to 1000
showAssigned
showCompleted
Defaults to True
showDeleted
showHidden
updatedMin

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List task lists

Description

Fetches the authenticated user's task lists from Google Tasks; results may be paginated.

Action Parameters

maxResults
integerDefaults to 20
pageToken

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: List Tasks

Description

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
completedMin
dueMax
dueMin
maxResults
pageToken
showCompleted
showDeleted
showHidden
tasklist_id
stringRequired
updatedMin

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Move Task

Description

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

Action Parameters

destinationTasklist
parent
previous
task
stringRequired
tasklist
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch Task

Description

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
deleted
due
etag
hidden
id
notes
status
task_id
stringRequired
tasklist_id
stringRequired
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Patch task list

Description

Updates the title of an existing Google Tasks task list.

Action Parameters

tasklist_id
stringRequired
updated_title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Task

Description

Updates the specified task.

Action Parameters

due
notes
status
task
stringRequired
tasklist
stringRequired
title

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Update Task List

Description

Updates the authenticated user's specified task list.

Action Parameters

tasklist_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired