Google Tasks: List task lists — MCP tool

Google Tasks MCP tool: Lists the user's task lists — the entry point for every other tool.

Technical name: list_tasklists

What task it solves

I want to see my task lists.

Returns the user's task lists: id, title and updated timestamp for each.

When to use it

Start here: every task tool needs a task list id. Skip it only when the default list is enough — that one is addressable as "@default" without listing first.

What to provide

• page_size — optional. Max task lists per page (1..1000; the API's default is 1000).
• page_token — optional. nextPageToken from the previous page.

What it returns

The items[] array of task lists (id, title, updated, selfLink) and nextPageToken when more pages exist. Tasks themselves are not included — fetch them per list with list_tasks.

What changes in Google Tasks

The tool reads Google Tasks data and does not change it.

Example request

List my task lists in Google Tasks.

Errors and limitations

Up to 1000 lists per page, so a single call usually returns everything. Google caps the number of lists per account. There is no filter or search — match titles client-side.

Access also depends on token permissions, quotas, and upstream API limits.

Related MCP tools

• Get a task list — get_tasklist
• Create a task list — create_tasklist
• List tasks — list_tasks

Technical details

• Impact: read-only
• Group: Task lists
• Description source: list_tasklists registration in src/tools/tasklists.ts
• Full technical reference
• All MCP capabilities