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-workflow
Execute cross-service Google Workspace workflows to automate productivity tasks across Gmail, Calendar, Drive, and Tasks.
gws-workflow-email-to-task
Convert Gmail messages into Google Tasks entries with a single command.
gws-workflow-file-announce
Announce a Google Drive file in a Chat space with a single command.
gws-workflow-meeting-prep
Prepare for your next meeting with agenda, attendees, and linked docs from Google Calendar.
gws-workflow-standup-report
Generate today's standup summary from Google Calendar meetings and open tasks.
gws-workflow-weekly-digest
Get a weekly summary of your meetings and unread email count from Google Workspace.