Frontmatter
{
"name": "google-tasks-tool",
"tags": [
"tasks",
"google",
"todo",
"external"
],
"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."
}
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)
