Use Google 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.
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 for setup.
Setting Value Redirect URI <NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/google-tasksEnvironment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
Scope Description https://www.googleapis.com/auth/userinfo.emailView email address https://www.googleapis.com/auth/userinfo.profileView basic profile info https://www.googleapis.com/auth/tasksCreate, read, update, and delete Google Tasks
Create, read, update, delete, and list tasks and task lists.
Create a new task in a Google Tasks list
Parameter Type Required Description taskListIdstring No Task list ID (defaults to primary task list "@default") titlestring Yes Title of the task (max 1024 characters) notesstring No Notes/description for the task (max 8192 characters) duestring No Due date in RFC 3339 format (e.g., 2025-06-03T00:00:00.000Z) statusstring No Task status: "needsAction" or "completed" parentstring No Parent task ID to create this task as a subtask. Omit for top-level tasks. previousstring No Previous sibling task ID to position after. Omit to place first among siblings.
Parameter Type Description idstring Task ID titlestring Task title notesstring Task notes statusstring Task status (needsAction or completed) duestring Due date updatedstring Last modification time selfLinkstring URL for the task webViewLinkstring Link to task in Google Tasks UI parentstring Parent task ID positionstring Position among sibling tasks completedstring Completion date deletedboolean Whether the task is deleted
List all tasks in a Google Tasks list
Parameter Type Required Description taskListIdstring No Task list ID (defaults to primary task list "@default") maxResultsnumber No Maximum number of tasks to return (default 20, max 100) pageTokenstring No Token for pagination showCompletedboolean No Whether to show completed tasks (default true) showDeletedboolean No Whether to show deleted tasks (default false) showHiddenboolean No Whether to show hidden tasks (default false) dueMinstring No Lower bound for due date filter (RFC 3339 timestamp) dueMaxstring No Upper bound for due date filter (RFC 3339 timestamp) completedMinstring No Lower bound for task completion date (RFC 3339 timestamp) completedMaxstring No Upper bound for task completion date (RFC 3339 timestamp) updatedMinstring No Lower bound for last modification time (RFC 3339 timestamp)
Parameter Type Description tasksarray 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 nextPageTokenstring Token for retrieving the next page of results
Retrieve a specific task by ID from a Google Tasks list
Parameter Type Required Description taskListIdstring No Task list ID (defaults to primary task list "@default") taskIdstring Yes The ID of the task to retrieve
Parameter Type Description idstring Task ID titlestring Task title notesstring Task notes statusstring Task status (needsAction or completed) duestring Due date updatedstring Last modification time selfLinkstring URL for the task webViewLinkstring Link to task in Google Tasks UI parentstring Parent task ID positionstring Position among sibling tasks completedstring Completion date deletedboolean Whether the task is deleted
Update an existing task in a Google Tasks list
Parameter Type Required Description taskListIdstring No Task list ID (defaults to primary task list "@default") taskIdstring Yes The ID of the task to update titlestring No New title for the task notesstring No New notes for the task duestring No New due date in RFC 3339 format statusstring No New status: "needsAction" or "completed"
Parameter Type Description idstring Task ID titlestring Task title notesstring Task notes statusstring Task status (needsAction or completed) duestring Due date updatedstring Last modification time selfLinkstring URL for the task webViewLinkstring Link to task in Google Tasks UI parentstring Parent task ID positionstring Position among sibling tasks completedstring Completion date deletedboolean Whether the task is deleted
Delete a task from a Google Tasks list
Parameter Type Required Description taskListIdstring No Task list ID (defaults to primary task list "@default") taskIdstring Yes The ID of the task to delete
Parameter Type Description taskIdstring Deleted task ID deletedboolean Whether deletion was successful
Retrieve all task lists for the authenticated user
Parameter Type Required Description maxResultsnumber No Maximum number of task lists to return (default 20, max 100) pageTokenstring No Token for pagination
Parameter Type Description taskListsarray 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 nextPageTokenstring Token for retrieving the next page of results
