# Google Tasks (/integrations/google_tasks)





{/* MANUAL-CONTENT-START:intro */}

Use [Google Tasks](https://support.google.com/tasks) to create, list, update, and delete tasks, or list the task lists in a Google account. Task inputs include titles, notes, due dates, and completion status.

{/* MANUAL-CONTENT-END */}

## OAuth scopes [#oauth-scopes]

Sim requests these scopes when someone connects a Google Tasks account. For a self-hosted deployment, register your own app with the provider using the settings below. See [Integrations and OAuth](/platform/self-hosting/integrations-oauth) for setup.

| Setting | Value |
| - | - |
| Redirect URI | `<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/google-tasks` |
| Environment variables | `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` |

| Scope | Description |
| - | - |
| `https://www.googleapis.com/auth/userinfo.email` | View email address |
| `https://www.googleapis.com/auth/userinfo.profile` | View basic profile info |
| `https://www.googleapis.com/auth/tasks` | Create, read, update, and delete Google Tasks |

## Use the block [#usage-instructions]

Create, read, update, delete, and list tasks and task lists.

## Actions [#actions]

### Google Tasks Create Task [#google-tasks-create-task]

Create a new task in a Google Tasks list

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `taskListId` | string | No | Task list ID (defaults to primary task list "@default") |
| `title` | string | Yes | Title of the task (max 1024 characters) |
| `notes` | string | No | Notes/description for the task (max 8192 characters) |
| `due` | string | No | Due date in RFC 3339 format (e.g., 2025-06-03T00:00:00.000Z) |
| `status` | string | No | Task status: "needsAction" or "completed" |
| `parent` | string | No | Parent task ID to create this task as a subtask. Omit for top-level tasks. |
| `previous` | string | No | Previous sibling task ID to position after. Omit to place first among siblings. |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `id` | string | Task ID |
| `title` | string | Task title |
| `notes` | string | Task notes |
| `status` | string | Task status (needsAction or completed) |
| `due` | string | Due date |
| `updated` | string | Last modification time |
| `selfLink` | string | URL for the task |
| `webViewLink` | string | Link to task in Google Tasks UI |
| `parent` | string | Parent task ID |
| `position` | string | Position among sibling tasks |
| `completed` | string | Completion date |
| `deleted` | boolean | Whether the task is deleted |

### Google Tasks List Tasks [#google-tasks-list-tasks]

List all tasks in a Google Tasks list

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `taskListId` | string | No | Task list ID (defaults to primary task list "@default") |
  | `maxResults` | number | No | Maximum number of tasks to return (default 20, max 100) |
  | `pageToken` | string | No | Token for pagination |
  | `showCompleted` | boolean | No | Whether to show completed tasks (default true) |
  | `showDeleted` | boolean | No | Whether to show deleted tasks (default false) |
  | `showHidden` | boolean | No | Whether to show hidden tasks (default false) |
  | `dueMin` | string | No | Lower bound for due date filter (RFC 3339 timestamp) |
  | `dueMax` | string | No | Upper bound for due date filter (RFC 3339 timestamp) |
  | `completedMin` | string | No | Lower bound for task completion date (RFC 3339 timestamp) |
  | `completedMax` | string | No | Upper bound for task completion date (RFC 3339 timestamp) |
  | `updatedMin` | string | No | Lower bound for last modification time (RFC 3339 timestamp) |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `tasks` | array | List of tasks |
  | ↳ `id` | string | Task identifier |
  | ↳ `title` | string | Title of the task |
  | ↳ `notes` | string | Notes/description for the task |
  | ↳ `status` | string | Task status: "needsAction" or "completed" |
  | ↳ `due` | string | Due date (RFC 3339 timestamp) |
  | ↳ `completed` | string | Completion date (RFC 3339 timestamp) |
  | ↳ `updated` | string | Last modification time (RFC 3339 timestamp) |
  | ↳ `selfLink` | string | URL pointing to this task |
  | ↳ `webViewLink` | string | Link to task in Google Tasks UI |
  | ↳ `parent` | string | Parent task identifier |
  | ↳ `position` | string | Position among sibling tasks (string-based ordering) |
  | ↳ `hidden` | boolean | Whether the task is hidden |
  | ↳ `deleted` | boolean | Whether the task is deleted |
  | ↳ `links` | array | Collection of links associated with the task |
  | ↳ `type` | string | Link type (e.g., "email", "generic", "chat\_message") |
  | ↳ `description` | string | Link description |
  | ↳ `link` | string | The URL |
  | `nextPageToken` | string | Token for retrieving the next page of results |
</ReferenceDetails>

### Google Tasks Get Task [#google-tasks-get-task]

Retrieve a specific task by ID from a Google Tasks list

#### Input [#input-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `taskListId` | string | No | Task list ID (defaults to primary task list "@default") |
| `taskId` | string | Yes | The ID of the task to retrieve |

#### Output [#output-2]

| Parameter | Type | Description |
| - | - | - |
| `id` | string | Task ID |
| `title` | string | Task title |
| `notes` | string | Task notes |
| `status` | string | Task status (needsAction or completed) |
| `due` | string | Due date |
| `updated` | string | Last modification time |
| `selfLink` | string | URL for the task |
| `webViewLink` | string | Link to task in Google Tasks UI |
| `parent` | string | Parent task ID |
| `position` | string | Position among sibling tasks |
| `completed` | string | Completion date |
| `deleted` | boolean | Whether the task is deleted |

### Google Tasks Update Task [#google-tasks-update-task]

Update an existing task in a Google Tasks list

#### Input [#input-3]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `taskListId` | string | No | Task list ID (defaults to primary task list "@default") |
| `taskId` | string | Yes | The ID of the task to update |
| `title` | string | No | New title for the task |
| `notes` | string | No | New notes for the task |
| `due` | string | No | New due date in RFC 3339 format |
| `status` | string | No | New status: "needsAction" or "completed" |

#### Output [#output-3]

| Parameter | Type | Description |
| - | - | - |
| `id` | string | Task ID |
| `title` | string | Task title |
| `notes` | string | Task notes |
| `status` | string | Task status (needsAction or completed) |
| `due` | string | Due date |
| `updated` | string | Last modification time |
| `selfLink` | string | URL for the task |
| `webViewLink` | string | Link to task in Google Tasks UI |
| `parent` | string | Parent task ID |
| `position` | string | Position among sibling tasks |
| `completed` | string | Completion date |
| `deleted` | boolean | Whether the task is deleted |

### Google Tasks Delete Task [#google-tasks-delete-task]

Delete a task from a Google Tasks list

#### Input [#input-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `taskListId` | string | No | Task list ID (defaults to primary task list "@default") |
| `taskId` | string | Yes | The ID of the task to delete |

#### Output [#output-4]

| Parameter | Type | Description |
| - | - | - |
| `taskId` | string | Deleted task ID |
| `deleted` | boolean | Whether deletion was successful |

### Google Tasks List Task Lists [#google-tasks-list-task-lists]

Retrieve all task lists for the authenticated user

#### Input [#input-5]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `maxResults` | number | No | Maximum number of task lists to return (default 20, max 100) |
| `pageToken` | string | No | Token for pagination |

#### Output [#output-5]

| Parameter | Type | Description |
| - | - | - |
| `taskLists` | array | List of task lists |
| ↳ `id` | string | Task list identifier |
| ↳ `title` | string | Title of the task list |
| ↳ `updated` | string | Last modification time (RFC 3339 timestamp) |
| ↳ `selfLink` | string | URL pointing to this task list |
| `nextPageToken` | string | Token for retrieving the next page of results |