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 tasksExit 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 listsCreate 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 tasksList 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-completedCreate 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-25Create 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-30Complete 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-completedTask 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, 20252025-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
.envfile 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