|
| 1 | +--- |
| 2 | +title: Google Tasks |
| 3 | +description: Manage Google Tasks |
| 4 | +--- |
| 5 | + |
| 6 | +import { BlockInfoCard } from "@/components/ui/block-info-card" |
| 7 | + |
| 8 | +<BlockInfoCard |
| 9 | + type="google_tasks" |
| 10 | + color="#E0E0E0" |
| 11 | +/> |
| 12 | + |
| 13 | +## Usage Instructions |
| 14 | + |
| 15 | +Integrate Google Tasks into your workflow. Create, read, update, delete, and list tasks and task lists. |
| 16 | + |
| 17 | + |
| 18 | + |
| 19 | +## Tools |
| 20 | + |
| 21 | +### `google_tasks_create` |
| 22 | + |
| 23 | +Create a new task in a Google Tasks list |
| 24 | + |
| 25 | +#### Input |
| 26 | + |
| 27 | +| Parameter | Type | Required | Description | |
| 28 | +| --------- | ---- | -------- | ----------- | |
| 29 | +| `taskListId` | string | No | Task list ID \(defaults to primary task list "@default"\) | |
| 30 | +| `title` | string | Yes | Title of the task \(max 1024 characters\) | |
| 31 | +| `notes` | string | No | Notes/description for the task \(max 8192 characters\) | |
| 32 | +| `due` | string | No | Due date in RFC 3339 format \(e.g., 2025-06-03T00:00:00.000Z\) | |
| 33 | +| `status` | string | No | Task status: "needsAction" or "completed" | |
| 34 | +| `parent` | string | No | Parent task ID to create this task as a subtask. Omit for top-level tasks. | |
| 35 | +| `previous` | string | No | Previous sibling task ID to position after. Omit to place first among siblings. | |
| 36 | + |
| 37 | +#### Output |
| 38 | + |
| 39 | +| Parameter | Type | Description | |
| 40 | +| --------- | ---- | ----------- | |
| 41 | +| `id` | string | Task ID | |
| 42 | +| `title` | string | Task title | |
| 43 | +| `notes` | string | Task notes | |
| 44 | +| `status` | string | Task status \(needsAction or completed\) | |
| 45 | +| `due` | string | Due date | |
| 46 | +| `updated` | string | Last modification time | |
| 47 | +| `selfLink` | string | URL for the task | |
| 48 | +| `webViewLink` | string | Link to task in Google Tasks UI | |
| 49 | +| `parent` | string | Parent task ID | |
| 50 | +| `position` | string | Position among sibling tasks | |
| 51 | +| `completed` | string | Completion date | |
| 52 | +| `deleted` | boolean | Whether the task is deleted | |
| 53 | + |
| 54 | +### `google_tasks_list` |
| 55 | + |
| 56 | +List all tasks in a Google Tasks list |
| 57 | + |
| 58 | +#### Input |
| 59 | + |
| 60 | +| Parameter | Type | Required | Description | |
| 61 | +| --------- | ---- | -------- | ----------- | |
| 62 | +| `taskListId` | string | No | Task list ID \(defaults to primary task list "@default"\) | |
| 63 | +| `maxResults` | number | No | Maximum number of tasks to return \(default 20, max 100\) | |
| 64 | +| `pageToken` | string | No | Token for pagination | |
| 65 | +| `showCompleted` | boolean | No | Whether to show completed tasks \(default true\) | |
| 66 | +| `showDeleted` | boolean | No | Whether to show deleted tasks \(default false\) | |
| 67 | +| `showHidden` | boolean | No | Whether to show hidden tasks \(default false\) | |
| 68 | +| `dueMin` | string | No | Lower bound for due date filter \(RFC 3339 timestamp\) | |
| 69 | +| `dueMax` | string | No | Upper bound for due date filter \(RFC 3339 timestamp\) | |
| 70 | +| `completedMin` | string | No | Lower bound for task completion date \(RFC 3339 timestamp\) | |
| 71 | +| `completedMax` | string | No | Upper bound for task completion date \(RFC 3339 timestamp\) | |
| 72 | +| `updatedMin` | string | No | Lower bound for last modification time \(RFC 3339 timestamp\) | |
| 73 | + |
| 74 | +#### Output |
| 75 | + |
| 76 | +| Parameter | Type | Description | |
| 77 | +| --------- | ---- | ----------- | |
| 78 | +| `tasks` | json | Array of tasks with id, title, notes, status, due, updated, and more | |
| 79 | +| `nextPageToken` | string | Token for retrieving the next page of results | |
| 80 | + |
| 81 | +### `google_tasks_get` |
| 82 | + |
| 83 | +Retrieve a specific task by ID from a Google Tasks list |
| 84 | + |
| 85 | +#### Input |
| 86 | + |
| 87 | +| Parameter | Type | Required | Description | |
| 88 | +| --------- | ---- | -------- | ----------- | |
| 89 | +| `taskListId` | string | No | Task list ID \(defaults to primary task list "@default"\) | |
| 90 | +| `taskId` | string | Yes | The ID of the task to retrieve | |
| 91 | + |
| 92 | +#### Output |
| 93 | + |
| 94 | +| Parameter | Type | Description | |
| 95 | +| --------- | ---- | ----------- | |
| 96 | +| `id` | string | Task ID | |
| 97 | +| `title` | string | Task title | |
| 98 | +| `notes` | string | Task notes | |
| 99 | +| `status` | string | Task status \(needsAction or completed\) | |
| 100 | +| `due` | string | Due date | |
| 101 | +| `updated` | string | Last modification time | |
| 102 | +| `selfLink` | string | URL for the task | |
| 103 | +| `webViewLink` | string | Link to task in Google Tasks UI | |
| 104 | +| `parent` | string | Parent task ID | |
| 105 | +| `position` | string | Position among sibling tasks | |
| 106 | +| `completed` | string | Completion date | |
| 107 | +| `deleted` | boolean | Whether the task is deleted | |
| 108 | + |
| 109 | +### `google_tasks_update` |
| 110 | + |
| 111 | +Update an existing task in a Google Tasks list |
| 112 | + |
| 113 | +#### Input |
| 114 | + |
| 115 | +| Parameter | Type | Required | Description | |
| 116 | +| --------- | ---- | -------- | ----------- | |
| 117 | +| `taskListId` | string | No | Task list ID \(defaults to primary task list "@default"\) | |
| 118 | +| `taskId` | string | Yes | The ID of the task to update | |
| 119 | +| `title` | string | No | New title for the task | |
| 120 | +| `notes` | string | No | New notes for the task | |
| 121 | +| `due` | string | No | New due date in RFC 3339 format | |
| 122 | +| `status` | string | No | New status: "needsAction" or "completed" | |
| 123 | + |
| 124 | +#### Output |
| 125 | + |
| 126 | +| Parameter | Type | Description | |
| 127 | +| --------- | ---- | ----------- | |
| 128 | +| `id` | string | Task ID | |
| 129 | +| `title` | string | Task title | |
| 130 | +| `notes` | string | Task notes | |
| 131 | +| `status` | string | Task status \(needsAction or completed\) | |
| 132 | +| `due` | string | Due date | |
| 133 | +| `updated` | string | Last modification time | |
| 134 | +| `selfLink` | string | URL for the task | |
| 135 | +| `webViewLink` | string | Link to task in Google Tasks UI | |
| 136 | +| `parent` | string | Parent task ID | |
| 137 | +| `position` | string | Position among sibling tasks | |
| 138 | +| `completed` | string | Completion date | |
| 139 | +| `deleted` | boolean | Whether the task is deleted | |
| 140 | + |
| 141 | +### `google_tasks_delete` |
| 142 | + |
| 143 | +Delete a task from a Google Tasks list |
| 144 | + |
| 145 | +#### Input |
| 146 | + |
| 147 | +| Parameter | Type | Required | Description | |
| 148 | +| --------- | ---- | -------- | ----------- | |
| 149 | +| `taskListId` | string | No | Task list ID \(defaults to primary task list "@default"\) | |
| 150 | +| `taskId` | string | Yes | The ID of the task to delete | |
| 151 | + |
| 152 | +#### Output |
| 153 | + |
| 154 | +| Parameter | Type | Description | |
| 155 | +| --------- | ---- | ----------- | |
| 156 | +| `taskId` | string | Deleted task ID | |
| 157 | +| `deleted` | boolean | Whether deletion was successful | |
| 158 | + |
| 159 | +### `google_tasks_list_task_lists` |
| 160 | + |
| 161 | +Retrieve all task lists for the authenticated user |
| 162 | + |
| 163 | +#### Input |
| 164 | + |
| 165 | +| Parameter | Type | Required | Description | |
| 166 | +| --------- | ---- | -------- | ----------- | |
| 167 | +| `maxResults` | number | No | Maximum number of task lists to return \(default 1000, max 1000\) | |
| 168 | +| `pageToken` | string | No | Token for pagination | |
| 169 | + |
| 170 | +#### Output |
| 171 | + |
| 172 | +| Parameter | Type | Description | |
| 173 | +| --------- | ---- | ----------- | |
| 174 | +| `taskLists` | json | Array of task lists with id, title, updated, and selfLink | |
| 175 | +| `nextPageToken` | string | Token for retrieving the next page of results | |
| 176 | + |
| 177 | + |
0 commit comments