Skip to content
Get packs

Google Tasks CLI

Lets an agent list, create, update, move and delete Google Tasks via the gws command-line tool.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

Once installed, the agent knows how to use the gws command-line tool to work with Google Tasks: viewing and managing task lists, adding or changing tasks, moving tasks under parents, and clearing completed items. Before calling any method it is told to look up the exact parameters with gws help and schema commands, so it builds requests from the official API definitions rather than guessing. It relies on a separate shared skill for sign-in and security rules.

Great for

  • People who want an AI assistant to manage their Google Tasks to-do lists
  • Developers automating task workflows against the Google Tasks API through the gws CLI
  • Users who already have gws installed and authenticated

Skip it if

  • Anyone expecting it to work without installing the gws tool and signing in to Google, since it only documents commands and does not provide access itself
  • Cases where deletion is risky: the delete and clear methods remove tasks (and, for assigned tasks, the originals in Docs or Chat Spaces), so an agent acting without review could remove data you need

Try asking

  • “Add a task called 'Renew passport' to my default task list due next Friday”
  • “Show me all incomplete tasks in my Work list”
  • “Move the 'Buy flour' task under the 'Baking weekend' parent task”
  • “Clear all completed tasks from my Personal list”
Step-by-step guide: how to use Google Tasks CLIInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-tasks.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

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

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to run gws schema for a method first if you want to see exactly what it will send before it acts.
  • Review destructive requests such as delete or clear before confirming, since removed tasks may not be recoverable through this skill.
  • Be specific about which task list you mean, since the agent otherwise has to list lists first.

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.