gws-tasks

Manage Google Tasks task lists and tasks via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-tasks-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-tasks
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-tasks
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-tasks-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Tasks from the command line or an AI agent normally requires hand-writing API calls against the Google Tasks REST API. This Skill exposes every tasklists and tasks method through the gws CLI so you can create, update, move, and delete tasks and lists without writing raw HTTP requests. ## Core Features & Use Cases - Task List Management: Create, list, get, update, patch, and delete task lists (up to 2000 lists per user). - Task Operations: Insert, list, get, update, patch, move, delete, and clear completed tasks within any list. - Schema Discovery: Inspect any method's required parameters, types, and defaults with gws schema tasks.<resource>.<method> before calling it. - Use Case: Ask your agent to list all open tasks in your "Work" list, create a new task with a due date, and clear completed items — all through authenticated gws commands. ## Quick Start Ask the agent to list all your Google Tasks task lists using the gws tasks tasklists list command.

Frequently Asked Questions about gws-tasks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list my Google Tasks from the command line?

Run gws tasks tasklists list to get all task lists, then gws tasks tasks list with the target list ID to retrieve its tasks. Use gws schema tasks.tasks.list first to see available filter parameters.

How do I create a task in Google Tasks with gws?

Use gws tasks tasks insert with the tasklist parameter and a --json body containing the task title and optional notes or due date. Inspect required fields first with gws schema tasks.tasks.insert.

What are the limits of the Google Tasks API?

A user can have up to 2000 task lists, 20,000 non-hidden tasks per list, 100,000 tasks total, and 2,000 subtasks per task. Tasks assigned from Docs or Chat Spaces cannot be created through the public API.

Why don't assigned tasks from Docs or Chat Spaces appear in task lists?

The tasks list method does not return assigned tasks by default. Tasks assigned from Docs or Chat Spaces can only be created from those surfaces, and deleting them via the API also deletes the original assignment.

What do I need before using the gws tasks commands?

You need the gws binary installed and authentication configured as described in the gws-shared skill. If that shared skill is missing, run gws generate-skills to create it before calling any tasks methods.