Google Tasks Skill | Agent Skills

Google Tasks

Create, update, and manage tasks and task lists in Google Tasks via OAuth authentication.

Pre-Flight Check (ALWAYS RUN FIRST)

python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service tasks

Exit codes:

0: Ready to use - proceed with user request
1: Need to login - run python3 00-system/skills/google/google-master/scripts/google_auth.py --login
2: Missing credentials or dependencies - see ../google-master/references/setup-guide.md

Quick Reference

List Task Lists

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py lists

Create Task List

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py create-list "Work Tasks"

List Tasks (Default List)

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py tasks

List Tasks (Specific List)

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py tasks --list <list_id>

List Tasks Including Completed

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py tasks --show-completed

Create Task

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py create "Buy groceries"

Create Task with Due Date

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py create "Submit report" --due 2025-12-25

Create Task with Notes

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py create "Call John" --notes "Discuss project timeline"

Create Subtask

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py create "Subtask" --parent <parent_task_id>

Update Task

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py update <task_id> --title "New title" --due 2025-12-30

Complete Task

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py complete <task_id>

Uncomplete Task

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py uncomplete <task_id>

Delete Task

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py delete <task_id>

Clear Completed Tasks

python3 00-system/skills/google/google-tasks/scripts/tasks_operations.py clear-completed

Task Status

| Status | Description | |--------|-------------| | needsAction | Task is incomplete (active) | | completed | Task is done |

Date Format

Due dates use YYYY-MM-DD format:

2025-12-25 - December 25, 2025
2025-01-01 - January 1, 2025

Available Operations

Task Lists

| Operation | Function | Description | |-----------|----------|-------------| | Lists | list_task_lists() | List all task lists | | Create List | create_task_list() | Create new task list | | Delete List | delete_task_list() | Delete a task list | | Rename List | rename_task_list() | Rename a task list |

Tasks

| Operation | Function | Description | |-----------|----------|-------------| | Tasks | list_tasks() | List tasks in a list | | Get | get_task() | Get task details | | Create | create_task() | Create new task | | Update | update_task() | Update task | | Complete | complete_task() | Mark as done | | Uncomplete | uncomplete_task() | Mark as not done | | Delete | delete_task() | Delete task | | Move | move_task() | Reorder or make subtask | | Clear | clear_completed() | Remove completed tasks |

Common Workflows

Daily Task Review

from tasks_operations import list_tasks

# Get incomplete tasks
tasks = list_tasks('@default', show_completed=False)
for task in tasks:
    print(f"- {task['title']} (due: {task['due']})")

Weekly Planning

from tasks_operations import create_task

weekly_tasks = [
    ("Monday standup", "2025-12-16"),
    ("Client call", "2025-12-17"),
    ("Submit report", "2025-12-20"),
]

for title, due in weekly_tasks:
    create_task('@default', title, due=due)

Error Handling

See ../google-master/references/error-handling.md for common errors and solutions.

Setup

First-time setup: ../google-master/references/setup-guide.md

Quick start:

pip install google-auth google-auth-oauthlib google-api-python-client
Create OAuth credentials in Google Cloud Console (enable Google Tasks API, choose "Desktop app")

Add to .env file at Nexus root:

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_PROJECT_ID=your-project-id

Run python3 00-system/skills/google/google-master/scripts/google_auth.py --login

Agent Skills: Google Tasks

Install this agent skill to your local

Skill Files