gws-tasks

Installation
Summary

Manage Google Tasks lists and individual tasks via command-line API calls.

  • Two resource types: tasklists (create, read, update, delete, list) and tasks (create, read, update, delete, list, move, clear completed)
  • Supports task hierarchy with up to 2,000 subtasks per task and enforces limits of 20,000 non-hidden tasks per list and 100,000 total tasks
  • Handles task assignments from Google Docs and Chat Spaces, with deletion cascading to assignment surfaces
  • Use gws schema to inspect method parameters and build --params or --json flags for each command
SKILL.md

tasks (v1)

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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.
Related skills
Installs
18.1K
GitHub Stars
26.1K
First Seen
Mar 4, 2026