google-tasks-tool

name	google-tasks-tool
description	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.
tags	["tasks","google","todo","external"]

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)