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