mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-06 03:00:16 -04:00
215 lines
8.4 KiB
Plaintext
215 lines
8.4 KiB
Plaintext
---
|
|
title: Google Tasks
|
|
description: Manage Google Tasks
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="google_tasks"
|
|
color="#E0E0E0"
|
|
/>
|
|
|
|
{/* MANUAL-CONTENT-START:intro */}
|
|
[Google Tasks](https://support.google.com/tasks) is Google's lightweight task management service, integrated into Gmail, Google Calendar, and the standalone Google Tasks app. It provides a simple way to create, organize, and track to-do items with support for due dates, subtasks, and task lists.
|
|
|
|
With the Google Tasks integration in Sim, you can:
|
|
|
|
- **Create tasks**: Add new to-do items to any task list with titles, notes, and due dates
|
|
- **List tasks**: Retrieve all tasks from a specific task list
|
|
- **Get task details**: Fetch detailed information about a specific task by ID
|
|
- **Update tasks**: Modify task titles, notes, due dates, or completion status
|
|
- **Delete tasks**: Remove tasks from a task list
|
|
- **List task lists**: Browse all available task lists in a Google account
|
|
|
|
In Sim, the Google Tasks integration allows your agents to manage to-do items programmatically as part of automated workflows. This enables use cases such as automated task creation from incoming data, deadline monitoring, and workflow-triggered task management.
|
|
{/* MANUAL-CONTENT-END */}
|
|
|
|
|
|
## Usage Instructions
|
|
|
|
Integrate Google Tasks into your workflow. Create, read, update, delete, and list tasks and task lists.
|
|
|
|
|
|
|
|
## Tools
|
|
|
|
### `google_tasks_create`
|
|
|
|
Create a new task in a Google Tasks list
|
|
|
|
#### 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
|
|
|
|
| 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`
|
|
|
|
List all tasks in a Google Tasks list
|
|
|
|
#### Input
|
|
|
|
| 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
|
|
|
|
| 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 |
|
|
|
|
### `google_tasks_get`
|
|
|
|
Retrieve a specific task by ID from a Google Tasks list
|
|
|
|
#### Input
|
|
|
|
| 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
|
|
|
|
| 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`
|
|
|
|
Update an existing task in a Google Tasks list
|
|
|
|
#### Input
|
|
|
|
| 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
|
|
|
|
| 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`
|
|
|
|
Delete a task from a Google Tasks list
|
|
|
|
#### Input
|
|
|
|
| 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
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `taskId` | string | Deleted task ID |
|
|
| `deleted` | boolean | Whether deletion was successful |
|
|
|
|
### `google_tasks_list_task_lists`
|
|
|
|
Retrieve all task lists for the authenticated user
|
|
|
|
#### Input
|
|
|
|
| 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
|
|
|
|
| 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 |
|
|
|
|
|