xuiltul

google-tasks-tool

Google Tasks integration for listing task lists and tasks and creating or updating tasks via OAuth2. Use when: fetching TODO lists, adding tasks, marking items complete, or switching task lists.

xuiltul 254 45 Updated 5mo ago
GitHub

Install

npx skillscat add xuiltul/animaworks/google-tasks-tool

Install via the SkillsCat registry.

About this skill

Here's a thinking process: 1. **Analyze the Request:** - **Goal:** Write a 2-3 sentence plain-text summary in English - **Subject:** Google Tasks integration skill for an AI agent - **Key points to cover:** What it does, what problem it solves, when to use it - **Constraints:** - Objective, factual tone only - No marketing language, no superlatives, no calls to action - Natural prose, no bullet points, no headings, no markdown formatting - Do not wrap in quotes - At most 60 words - **Output:** ONLY the summary text 2.

SKILL.md

Google Tasks Tool

External tool for Google Tasks API: list task lists, list tasks, create tasks.

Invocation via Bash

animaworks-tool google_tasks <subcommand> [args]

Actions

list_tasklists — List task lists

animaworks-tool google_tasks tasklists [-n 50]
Parameter Type Default Description
max_results integer 50 Max results

list_tasks — List tasks in a task list

animaworks-tool google_tasks list <tasklist_id> [-n 50] [--no-completed]
Parameter Type Required Description
tasklist_id string Yes Task list ID
max_results integer 50 Max results
show_completed boolean true Include completed tasks

insert_task — Add a task

animaworks-tool google_tasks add <tasklist_id> "Task title" [--notes notes] [--due datetime]
Parameter Type Required Description
tasklist_id string Yes Task list ID
title string Yes Task title
notes string No Notes
due string No Due date (RFC 3339)

insert_tasklist — Create a task list

animaworks-tool google_tasks new-list "List name"
Parameter Type Required Description
title string Yes List title

update_task — Update a task

Update a task's title, notes, due date, or status (only provided fields are updated).

animaworks-tool google_tasks update <tasklist_id> <task_id> [--title title] [--notes notes] [--due datetime] [--status completed|needsAction]
Parameter Type Required Description
tasklist_id string Yes Task list ID
task_id string Yes Task ID
title string No New title
notes string No Notes
due string No Due date (RFC 3339)
status string No needsAction (incomplete) or completed. At least one of title/notes/due/status required.

update_tasklist — Update a task list title

animaworks-tool google_tasks update-list <tasklist_id> "New list name"
Parameter Type Required Description
tasklist_id string Yes Task list ID
title string Yes New list title

Notes

  • OAuth2 flow required on first use
  • Place credentials.json at ~/.animaworks/credentials/google_tasks/ (same OAuth client as Gmail/Calendar can be copied)