Google Tasks: Get a task list — MCP tool
Google Tasks MCP tool: Fetches one task list's metadata by id.
Technical name: get_tasklist
What task it solves
I want to check a task list.
Returns one task list: id, title, updated timestamp and selfLink.
When to use it
Use it to confirm a list exists or read its current title when you already hold its id. To browse all lists use list_tasklists; to read the tasks inside use list_tasks.
What to provide
tasklist_id— required. The task list id from list_tasklists or create_tasklist output;"@default"targets the default list.
What it returns
The task list object. It carries only metadata — no tasks.
What changes in Google Tasks
The tool reads Google Tasks data and does not change it.
Example request
Show me the details of my default task list in Google Tasks.
Errors and limitations
A wrong or foreign id returns HTTP 404. This returns metadata only; the tasks come from list_tasks.
Access also depends on token permissions, quotas, and upstream API limits.
Related MCP tools
- List task lists —
list_tasklists - List tasks —
list_tasks - Rename a task list —
update_tasklist
Technical details
- Impact: read-only
- Group: Task lists
- Description source:
get_tasklistregistration insrc/tools/tasklists.ts - Full technical reference
- All MCP capabilities