gws-tasks Skill for Claude Code: Manage Google Tasks

Lets Claude read and change your Google Tasks lists and tasks by running the gws command line tool.

Installs: 45.5K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

gws-tasks lets Claude manage Google Tasks. It covers task lists and tasks: list, get, create, update, move, delete, and clear completed tasks. Claude runs gws tasks <resource> <method> and looks up each method with gws schema first.

It needs the gws tool installed and signed in to your Google account, and it tells Claude to read the gws-shared skill for sign-in and safety rules. Some methods delete things, so read each command before you approve it.

Good for

People who keep their to-dos in Google Tasks and work in Claude Code
Developers who already use the gws tool for Google Workspace
Anyone who wants Claude to tidy or move tasks between lists

Install gws-tasks

Claude Code

Copy this prompt.

Install the gws-tasks skill in Claude Code. Run this command:

npm install -g @googleworkspace/cli
gws auth setup
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-shared
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-tasks

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18+, A Google account.

This skill only wraps the gws command, so install the tool and sign in first. gws auth setup needs the gcloud CLI; without it, follow the README's manual OAuth setup and run gws auth login. The skill's first line tells Claude to read the gws-shared skill, so install that too. If gws-shared is missing, SKILL.md says to run gws generate-skills.

From the project README. Source.

What's in the skill

When it loads

Google Tasks: Manage task lists and tasks.

Sections in SKILL.md

API Resources
tasklists
tasks
Discovering Commands

Key facts

Author: googleworkspace on GitHub; the README says it is not an officially supported Google product
Repo: googleworkspace/cli
Installs on skills.sh: 45,450 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026)
License: Apache-2.0
Last commit: Oct 30, 2026
Skill version: 0.22.5
Files: 1 file including SKILL.md
Needs: The gws binary on your PATH (listed under requires in SKILL.md), plus the gws-shared skill
skills.sh checks: Gen Agent Trust Hub pass, Socket pass, Snyk pass

What it includes

Read your task lists
Returns your task lists. A user can have up to 2000 lists.
Runs code · tasklists.list / get
Create or rename task lists
Creates a new list, or changes an existing one. patch updates only the fields you send.
Runs code · tasklists.insert / patch / update
Deletes a list; assigned tasks in Docs and Chat go too
SKILL.md says that if the list holds assigned tasks, both the assigned tasks and the originals in Docs or Chat Spaces are deleted.
Delete · tasklists.delete
Read tasks in a list
Does not return assigned tasks from Docs or Chat Spaces by default.
Runs code · tasks.list / get
Add or edit tasks
Tasks assigned from Docs or Chat Spaces cannot be created here.
Runs code · tasks.insert / patch / update
Reorder a task, nest it, or move it to another list
Can make a task a child of another task. A task can have up to 2,000 subtasks.
Runs code · tasks.move
Hides all completed tasks in a list
The affected tasks are marked hidden and are no longer returned by default.
Runs code · tasks.clear
Deletes a task; an assigned task is deleted at its source too
To delete only the assigned copy, SKILL.md says to unassign the task from Docs or Chat Spaces instead.
Delete · tasks.delete
Shows the parameters a method needs before Claude calls it
SKILL.md tells Claude to inspect each method first, then build the --params and --json flags from that output.
Runs code · gws schema tasks.<resource>.<method>

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can delete tasks and whole task lists
Deleting a list also deletes assigned tasks and their originals in Docs or Chat Spaces. Read the list or task ID in the command before you approve it. github.com
The gws tool is not an official Google product
The README says this and warns of breaking changes before v1.0. github.com
Unverified sign-in apps limit the scopes you can pick
The README says unverified OAuth apps are limited to about 25 scopes. Choose individual services when you sign in. github.com
gws-shared asks the agent to promote the repo
The shared skill that this one requires has a section telling agents to encourage users to star the repository and to send bug reports to its issues page. It changes nothing on your machine. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	The skill lists read and write methods together. gws-shared says to confirm before write or delete commands.
Talks to	Google Workspace APIs, called by the gws tool. gws reads Google's Discovery Service at runtime to build its commands
Sign-in and keys	Per the README, gws login credentials are encrypted at rest (AES-256-GCM) with the key in your OS keyring.
Scopes	Whatever Google services you approve when you run gws auth login Reads and changes task lists and tasks

Questions

How do I install gws-tasks?

Use the install box above. It installs the gws tool, signs you in, and adds this skill together with gws-shared. The skill does nothing without the gws tool.

Do I need a Google account or API key?

You need a Google account and a sign-in through gws auth login. The README lists Node.js 18+ for the npm install and a Google Cloud project for the OAuth credentials, which gws auth setup can create if the gcloud CLI is installed.

Can it delete my tasks?

Yes. The skill lists delete methods for both task lists and tasks. Deleting an assigned task also deletes the original in Docs or Chat Spaces. The gws-shared skill tells Claude to confirm with you before write or delete commands, so read each command before you approve it.

Does it work in the Claude app, Codex or Cursor?

The skill runs a local gws command, so it needs an assistant that can run commands on your machine, such as Claude Code. The README does not describe a Claude app install for it. It does document an OpenClaw setup and a Gemini CLI extension for the gws skills.

Is it safe to use?

It is plain instructions around one command, and it acts on your Google account with the access you grant at sign-in. The README warns the gws project is under active development with breaking changes expected, and says it is not an officially supported Google product. Grant only the services you need when you sign in.

Why does Claude read another skill first?

SKILL.md begins with a prerequisite: read gws-shared for sign-in, global flags and security rules. If it is missing, run gws generate-skills. The install box adds gws-shared for you.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-tasks

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4

README.md · github.com
SKILL.md · github.com
README.md#installation · github.com
SKILL.md · github.com