Google Tasks
Create and manage Google task lists and tasks
OAuth12 native toolsIcon needs-review
This catalogue entry describes the current repository definition. Availability, scopes, and production readiness should be confirmed during private-beta onboarding.
Native tools
GET
google_tasks_list_task_lists
List the authenticated user's Google Tasks lists
/users/@me/lists
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| maxResults | integer | optional | Maximum task lists to return |
| pageToken | string | optional | Token for the next result page |
GET
google_tasks_get_task_list
Get one Google Tasks list
/users/@me/lists/{tasklist}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
POST
google_tasks_create_task_list
Create a Google Tasks list
/users/@me/lists
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| title | string | required | Task-list title |
PATCH
google_tasks_update_task_list
Rename a Google Tasks list
/users/@me/lists/{tasklist}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| title | string | required | New task-list title |
DELETE
google_tasks_delete_task_list
Delete a Google Tasks list
/users/@me/lists/{tasklist}
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
GET
google_tasks_list_tasks
List tasks in a Google Tasks list
/lists/{tasklist}/tasks
11 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| completedMax | string | optional | Maximum completion time (RFC 3339) |
| completedMin | string | optional | Minimum completion time (RFC 3339) |
| dueMax | string | optional | Maximum due date (RFC 3339) |
| dueMin | string | optional | Minimum due date (RFC 3339) |
| maxResults | integer | optional | Maximum tasks to return |
| pageToken | string | optional | Token for the next result page |
| showCompleted | boolean | optional | Include completed tasks |
| showDeleted | boolean | optional | Include deleted tasks |
| showHidden | boolean | optional | Include hidden tasks |
| updatedMin | string | optional | Minimum update time (RFC 3339) |
GET
google_tasks_get_task
Get one Google task
/lists/{tasklist}/tasks/{task}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| task | string | required | Google Tasks task identifier |
POST
google_tasks_create_task
Create a task or subtask in a Google Tasks list
/lists/{tasklist}/tasks
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| title | string | required | Task title |
| notes | string | optional | Task notes |
| due | string | optional | Due date as an RFC 3339 timestamp |
| status | string | optional | Task completion status |
| parent | string | optional | Parent task ID for a subtask |
| previous | string | optional | Previous sibling task ID |
PATCH
google_tasks_update_task
Update a Google task's fields or completion status
/lists/{tasklist}/tasks/{task}
7 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| task | string | required | Google Tasks task identifier |
| title | string | optional | Task title |
| notes | string | optional | Task notes |
| due | string | optional | Due date as an RFC 3339 timestamp |
| status | string | optional | — |
| completed | string | optional | Completion time as RFC 3339 |
DELETE
google_tasks_delete_task
Delete a Google task
/lists/{tasklist}/tasks/{task}
2 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| task | string | required | Google Tasks task identifier |
POST
google_tasks_move_task
Move, reorder, or re-parent a Google task
/lists/{tasklist}/tasks/{task}/move
5 parameters
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |
| task | string | required | Google Tasks task identifier |
| parent | string | optional | New parent task ID |
| previous | string | optional | New previous sibling task ID |
| destinationTasklist | string | optional | Destination task-list ID |
POST
google_tasks_clear_completed_tasks
Clear completed tasks from a Google Tasks list
/lists/{tasklist}/clear
1 parameter
| Param | Type | Required | Description |
|---|---|---|---|
| tasklist | string | required | Google Tasks task-list identifier |