gws-tasks
googleworkspace/cli
Manage Google Tasks lists and tasks via CLI.
What is gws-tasks?
Google Tasks skill provides command-line access to create, read, update, and delete task lists and individual tasks in Google Tasks. Use it to automate task management workflows, integrate task operations into scripts, or programmatically organize work across multiple task lists.
- Create, retrieve, update, and delete task lists
- Create, retrieve, update, and delete individual tasks
- Move tasks between lists or change task hierarchy with subtasks
- Clear completed tasks from a list
- List all task lists or all tasks within a specific list
- Patch task list and task properties using patch semantics
How to install gws-tasks
npx skills add null --skill gws-tasks- gws CLI installed and configured
- Google Workspace authentication set up (see gws-shared/SKILL.md)
- Access to Google Tasks API
How to use gws-tasks
- 1.Run `gws tasks --help` to browse available resources and methods
- 2.Use `gws schema tasks.<resource>.<method>` to inspect required parameters and types for your target operation
- 3.Build your command with `gws tasks <resource> <method>` and appropriate `--params` or `--json` flags
- 4.Execute the command to perform the desired task list or task operation
Use cases
- Automate task creation from external systems or workflows
- Programmatically organize tasks across multiple lists
- Clear completed tasks in bulk from a task list
- Move tasks between lists or reorganize task hierarchies
- Retrieve task lists and tasks for reporting or integration with other tools
- Developers automating task management workflows
- Productivity tool integrators
- DevOps engineers managing task-based processes
- Anyone building scripts that interact with Google Tasks
gws-tasks FAQ
A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.
A user can have up to 2,000 task lists at a time.
Yes, you can move tasks to be child tasks under a parent task. A user can have up to 2,000 subtasks per task.
If the task is assigned from Docs or Chat Spaces, both the assigned task and the original task in the assignment surface are deleted.
Use `gws tasks --help` to browse resources and methods, and `gws schema tasks.<resource>.<method>` to inspect required parameters and types.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-tasks description: "Google Tasks: Manage task lists and tasks." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws tasks --help"
tasks (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws tasks <resource> <method> [flags]
API Resources
tasklists
delete— Deletes the authenticated user's specified task list. If the list contains assigned tasks, both the assigned tasks and the original tasks in the assignment surface (Docs, Chat Spaces) are deleted.get— Returns the authenticated user's specified task list.insert— Creates a new task list and adds it to the authenticated user's task lists. A user can have up to 2000 lists at a time.list— Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.patch— Updates the authenticated user's specified task list. This method supports patch semantics.update— Updates the authenticated user's specified task list.
tasks
clear— Clears all completed tasks from the specified task list. The affected tasks will be marked as 'hidden' and no longer be returned by default when retrieving all tasks for a task list.delete— Deletes the specified task from the task list. If the task is assigned, both the assigned task and the original task (in Docs, Chat Spaces) are deleted. To delete the assigned task only, navigate to the assignment surface and unassign the task from there.get— Returns the specified task.insert— Creates a new task on the specified task list. Tasks assigned from Docs or Chat Spaces cannot be inserted from Tasks Public API; they can only be created by assigning them from Docs or Chat Spaces. A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.list— Returns all tasks in the specified task list. Doesn't return assigned tasks by default (from Docs, Chat Spaces). A user can have up to 20,000 non-hidden tasks per list and up to 100,000 tasks in total at a time.move— Moves the specified task to another position in the destination task list. If the destination list is not specified, the task is moved within its current list. This can include putting it as a child task under a new parent and/or move it to a different position among its sibling tasks. A user can have up to 2,000 subtasks per task.patch— Updates the specified task. This method supports patch semantics.update— Updates the specified task.
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws tasks --help
# Inspect a method's required params, types, and defaults
gws schema tasks.<resource>.<method>
Use gws schema output to build your --params and --json flags.
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.