gws-tasks

What This Skill Does

The gws-tasks skill provides a comprehensive interface for interacting with the Google Tasks API directly through the OpenClaw AI agent. It allows users to manage both task lists and individual tasks, providing full CRUD (Create, Read, Update, Delete) capabilities. Whether you need to organize your daily workflow by creating new lists, track subtasks, or clean up your completed items, this skill handles the heavy lifting by interfacing with your Google Workspace account. It is built to ensure synchronization with the Google ecosystem while respecting the API constraints set by Google, such as list and task limits.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-tasks

Before you begin, ensure you have completed the prerequisite setup by reading the ../gws-shared/SKILL.md file located in your local repository. This file contains critical information regarding authentication, security protocols, and global flags required for successful API interaction. If these files are missing, run gws generate-skills to initialize the necessary framework.

Use Cases

This skill is ideal for power users who want to automate task management. Typical scenarios include:

• Task Consolidation: Automatically moving completed tasks to a "Done" list or clearing finished tasks to maintain a clean workspace.
• Project Organization: Programmatically creating task lists for new projects and populating them with individual action items.
• Subtask Hierarchy: Organizing complex projects by utilizing the move functionality to nest tasks under specific parent items.
• Workflow Automation: Building scripts that query tasks and trigger other AI-driven workflows based on the status or content of your lists.

Example Prompts

1. "Hey OpenClaw, please list all my active tasks in my 'Work Projects' task list and tell me how many I have left to complete."
2. "Create a new task list titled 'Vacation Planning' and add 'Book flight', 'Reserve hotel', and 'Buy travel insurance' as tasks."
3. "Can you clear all the completed tasks from my 'Daily Chores' list to keep things tidy?"

Tips & Limitations

• Rate Limits: Be aware of Google's hard limits; you are capped at 2,000 lists and 100,000 tasks total, with a 20,000 non-hidden task limit per list.
• Assigned Tasks: Note that tasks assigned via Google Docs or Chat Spaces are handled differently. Deleting an assigned task via this tool will remove it from its source; if you only want to unassign, perform that action directly in the source application.
• Schema Discovery: Always use gws schema tasks.<resource>.<method> before executing complex commands to ensure you are providing the correct parameter formats, as this prevents errors caused by mismatched data types.