Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-tasks — Claude Code skill: what it does, how to install

Manages Google Tasks lists and items via the gws CLI. It suits projects where an agent needs to track tasks in Google Workspace.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add googleworkspace/cli --skill gws-tasks -a claude-code
Open on GitHub

What gws-tasks does

The skill allows an AI agent to control Google Tasks through the gws tasks command line tool. It covers both tasklists and individual tasks endpoints, including methods to create, get, patch, update, and delete entries. You can also reorder items, nest subtasks, or hide completed tasks with the clear method.

Execution requires the gws binary on your path. The agent inspects required inputs using gws schema tasks.. before generating --params or --json arguments. Standard API limits apply: up to 2000 lists per account, 20,000 non-hidden tasks per list, and 2,000 subtasks under any single task.

This skill is unnecessary if you do not use Google Tasks. It pays off when your workflow already centers on Google Workspace and you want your agent to handle action items directly.

What it helps with

  • Create new tasks or subtasks inside an existing Google Tasks list
  • Retrieve active task lists and filter out completed items
  • Clear completed items from a task list
  • Move a task under a new parent or to another position

Example prompts for the agent

  • List all my Google Tasks tasklists
  • Add a task Review server logs to my primary list
  • Clear completed tasks from my sprint list

How to install gws-tasks

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-tasks -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-tasks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-tasks/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

launch coreyhaines31 Plans SaaS product launches, feature announcements, and GTM rollouts. It structures audience channels and stops teams from polishing code forever. Claude Code CX Codex Cursor +1 77,700installs free-tools coreyhaines31 Helps you decide whether a free tool is worth building for leads and links, and how to scope it. Claude Code CX Codex Cursor +1 73,400installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. Claude Code 862,247installs

Questions about gws-tasks

How to install gws-tasks in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-tasks -a claude-code. This installs the skill file into your Claude Code environment.

What is required before using gws-tasks?

You need the gws executable installed on your system. Shared credentials and security flags must also be configured in ../gws-shared/SKILL.md.

What are the main limits for Google Tasks in this skill?

The API allows up to 2000 task lists, 20,000 non-hidden tasks per list, and up to 2,000 subtasks per task.

Source text

SKILL.md · Apache-2.0 
---
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.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

```bash
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:

```bash
# 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.

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor