Google Tasks

App · To-Do Lists · 4 actions

Manage task lists and tasks in Google Tasks.

Actions

ActionWhat it does
Complete taskMark a task as completed.
Create taskCreate a new task in a task list.
List task listsList the task lists in your Google account.
List tasksList the tasks in a task list.

Complete task

Mark a task as completed.

Inputs

Task list IDtask_list_idtextRequired
ID of the task list the task belongs to.
Task IDtask_idtextRequired
ID of the task to complete.

Outputs

idtext
ID of the completed task
statustext
Task status after completion (always 'completed')
Example output
{
  "id": "task_abc123",
  "status": "completed"
}

Create task

Create a new task in a task list.

Inputs

Task list IDtask_list_idtextRequired
ID of the task list to add the task to.
TitletitletextRequired
Title of the task.
Notesnotestext
Notes/description for the task.
Due dateduedate and time
Due date for the task, as an RFC 3339 timestamp (e.g. 2026-02-01T00:00:00Z).

Outputs

idtext
ID of the created task. Use this with complete_task.
Example output
{
  "id": "task_abc123"
}

List task lists

List the task lists in your Google account.

Inputs

None.

Outputs

task_listslist
List of task lists
Example output
{
  "task_lists": [
    {
      "id": "list_abc123",
      "title": "My Tasks"
    }
  ]
}

List tasks

List the tasks in a task list.

Inputs

Task list IDtask_list_idtextRequired
ID of the task list to list tasks from.
Show completedshow_completedtrue/false
Whether to include completed tasks (default true).

Outputs

taskslist
List of tasks
Example output
{
  "tasks": [
    {
      "due": "2026-02-01T00:00:00.000Z",
      "id": "task_abc123",
      "notes": "Sent the proposal, waiting on a reply.",
      "status": "needsAction",
      "title": "Follow up with customer"
    }
  ]
}

On this page