google_skill

Overview

This skill manages Google Tasks and task lists using OAuth-authenticated access to your Google account. It provides commands and functions to create, update, complete, delete, and organize tasks and task lists. Use it to script task workflows or operate interactively from the command line or Python code.

How this skill works

The skill authenticates via OAuth and calls the Google Tasks API to perform operations on task lists and tasks. It exposes command-line scripts and Python functions for listing task lists, creating and renaming lists, listing and creating tasks, updating task properties (title, due date, notes), marking tasks completed/uncompleted, moving tasks, and clearing completed items. Date inputs use YYYY-MM-DD format and task status follows needsAction or completed.

When to use it

• Automate daily or weekly task creation and review workflows
• Integrate Google Tasks into scripts, cron jobs, or other automation
• Quickly add, complete, or modify tasks from the command line
• Manage multiple task lists (work, personal, projects) programmatically
• Clean up completed tasks or reorder tasks and subtasks

Best practices

• Run the OAuth pre-flight check before any operation to ensure valid credentials
• Use YYYY-MM-DD for due dates to avoid parsing issues
• Keep task lists scoped (one list per project or context) for easier automation
• Write idempotent scripts when creating tasks to avoid duplicates
• Handle API errors and token refreshes according to Google auth guidelines

Example use cases

• Daily review script that lists incomplete tasks and prints titles with due dates
• Weekly planner that creates a set of tasks with due dates for the coming week
• Command-line quick add: create a task with notes and an optional due date
• Project cleanup: clear completed tasks from a specific task list
• Reorganize tasks by moving items to be subtasks under a parent task