Google Tasks

Access the Google Tasks API with managed OAuth authentication. Manage task lists and tasks with full CRUD operations.

Reference

List All Task Lists

GET /google-tasks/tasks/v1/users/@me/lists

maton google-tasks tasklist list

Query Parameters:

maxResults - Maximum number of task lists to return (default: 20, max: 100)
pageToken - Token for pagination

Get Task List

GET /google-tasks/tasks/v1/users/@me/lists/{tasklistId}

maton google-tasks tasklist view <tasklistId>

Create Task List

POST /google-tasks/tasks/v1/users/@me/lists
Content-Type: application/json

{
  "title": "New Task List"
}

maton google-tasks tasklist create --title 'New Task List'

Update Task List (PATCH - partial update)

PATCH /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Content-Type: application/json

{
  "title": "Updated Title"
}

maton google-tasks tasklist update <tasklistId> --title 'Updated Title'

Update Task List (PUT - full replace)

PUT /google-tasks/tasks/v1/users/@me/lists/{tasklistId}
Content-Type: application/json

{
  "title": "Replaced Title"
}

maton google-tasks tasklist update <tasklistId> --title 'Replaced Title' --replace

Delete Task List

DELETE /google-tasks/tasks/v1/users/@me/lists/{tasklistId}

maton google-tasks tasklist delete <tasklistId>

List Tasks

GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks?showCompleted=true

maton google-tasks task list -l <tasklistId> --show-completed

Query Parameters:

maxResults - Maximum number of tasks to return (default: 20, max: 100)
pageToken - Token for pagination
showCompleted - Include completed tasks (default: true)
showDeleted - Include deleted tasks (default: false)
showHidden - Include hidden tasks (default: false)
dueMin - Lower bound for due date (RFC 3339 timestamp)
dueMax - Upper bound for due date (RFC 3339 timestamp)
completedMin - Lower bound for completion date (RFC 3339 timestamp)
completedMax - Upper bound for completion date (RFC 3339 timestamp)
updatedMin - Lower bound for last update time (RFC 3339 timestamp)

Get Task

GET /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}

maton google-tasks task view <taskId> -l <tasklistId>

Create Task

POST /google-tasks/tasks/v1/lists/{tasklistId}/tasks
Content-Type: application/json

{
  "title": "New Task",
  "notes": "Task description",
  "due": "2026-03-01T00:00:00.000Z"
}

maton google-tasks task create -l <tasklistId> --title 'New Task' --notes 'Task description' --due 2026-03-01

Query Parameters (optional):

parent - Parent task ID (for subtasks)
previous - Previous sibling task ID (for positioning)

Update Task (PATCH - partial update)

PATCH /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Content-Type: application/json

{
  "title": "Updated Task Title",
  "status": "completed"
}

maton google-tasks task update <taskId> -l <tasklistId> --title 'Updated Task Title' --status completed

Update Task (PUT - full replace)

PUT /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}
Content-Type: application/json

{
  "title": "Replaced Task",
  "notes": "New notes",
  "status": "needsAction"
}

maton google-tasks task update <taskId> -l <tasklistId> --title 'Replaced Task' --notes 'New notes' --status needsAction --replace

Delete Task

DELETE /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}

maton google-tasks task delete <taskId> -l <tasklistId>

Move Task

Reposition a task within a task list or change its parent.

POST /google-tasks/tasks/v1/lists/{tasklistId}/tasks/{taskId}/move

maton google-tasks task move <taskId> -l <tasklistId> --previous <siblingTaskId>