list_tasks
Retrieve tasks from a Google Tasks list with filters for completion, due dates, and pagination. Supports incremental sync via updated_min.
Instructions
List tasks in one task list, with rich filters and auto-pagination.
Auto-paginates internally to fill up to max_results. For one specific task use get_task. For write operations use manage_task. Completed tasks from the web UI / mobile apps are "hidden" by default — to see them set both show_completed=True AND show_hidden=True. Requires the tasks.readonly OAuth scope.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | The user's Google email address (authenticated account). | |
| task_list_id | Yes | Task list ID from list_task_lists. | |
| max_results | No | Cap on tasks returned across all pages. Default varies; hard cap 10000. | |
| page_token | No | Resume cursor from a prior call's "Next page token". | |
| show_completed | No | Include completed tasks. Default True. | |
| show_deleted | No | Include deleted tasks. Default False. | |
| show_hidden | No | Include tasks hidden from the UI (required alongside show_completed to see web/mobile-completed tasks). Default False. | |
| show_assigned | No | Include tasks assigned to the user. Default False. | |
| completed_max | No | RFC3339 upper bound on completion date. | |
| completed_min | No | RFC3339 lower bound on completion date. | |
| due_max | No | RFC3339 upper bound on due date. Auto-adjusted to include the boundary date's tasks. | |
| due_min | No | RFC3339 lower bound on due date. | |
| updated_min | No | RFC3339 lower bound on last-modified time — useful for incremental sync. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |