AutoGineer
Generated banner for Gws Tasks
Generated logo for Gws Tasks

Gws Tasks

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Google Tasks: Manage task lists and tasks.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-tasks skill provides a command-line interface to interact with the Google Tasks API. It allows users to programmatically manage task lists and individual tasks, including creating, updating, moving, and deleting items. The skill supports both task list management and granular task operations, such as clearing completed tasks or organizing subtasks, while adhering to Google Tasks' specific constraints and resource limits.

What it does

  • Create, retrieve, update, and delete Google Task lists.
  • Manage individual tasks within specific lists.
  • Clear completed tasks from a list to hide them.
  • Move tasks to different positions or nest them as subtasks.
  • Inspect API schemas to determine required parameters and data types.

When to use it

  • When you need to automate task management within your Google account.
  • When integrating Google Tasks into a custom CLI workflow.
  • When you need to perform bulk operations on task lists or tasks.
  • When you need to programmatically organize tasks and subtasks.

Advantages

  • Provides direct command-line access to Google Tasks functionality.
  • Supports granular control over task organization and hierarchy.
  • Allows for schema inspection to ensure correct parameter usage.
  • Integrates seamlessly with other gws-based tools.

Usage examples

“List all my Google Task lists.”
The agent executes the list method on the tasklists resource to display all available task lists.
“Create a new task named 'Submit report' in my 'Work' list.”
The agent uses the insert method on the tasks resource to add the specified task to the identified list.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/googleworkspace/gws-tasks/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-tasks.zip -d .agents/skills

Documentation by Google Workspace

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.

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.

Files

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.

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.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-tasks · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-tasks.zip