Fetch, display, create, and delete Google Tasks using the Google Tasks API. Use when the user asks to check, view, list, get, add, create, remove, or delete their Google Tasks, to-do lists, or task items. Handles OAuth authentication automatically using bash script with curl and jq.
Manage Google Tasks from all task lists using lightweight bash scripts.
bash scripts/get_tasks.sh
# Using default list (configured in google-tasks-config.sh)
bash scripts/create_task.sh "Task title" ["due-date"] ["notes"]
# Specifying list name
bash scripts/create_task.sh "List Name" "Task title" ["due-date"] ["notes"]
Examples:
# Simple task (uses default list)
bash scripts/create_task.sh "Buy groceries"
# Task with due date (uses default list)
bash scripts/create_task.sh "Finish report" "2026-02-10"
# Task with specific list
bash scripts/create_task.sh "Work" "Finish report" "2026-02-10"
# Task with list, due date, and notes
bash scripts/create_task.sh "Personal" "Call mom" "2026-02-05" "Ask about her health"
Default list configuration:
Edit google-tasks-config.sh to set your default list:
DEFAULT_LIST="Private" # Change to your preferred default
bash scripts/delete_task.sh "List Name" <task-number-or-title>
Examples:
# Delete by task number (position in list)
bash scripts/delete_task.sh "Work" 2
# Delete by task title
bash scripts/delete_task.sh "Inbox" "Buy groceries"
jq - JSON processor (usually pre-installed)curl - HTTP client (usually pre-installed)token.json with OAuth access tokenhttps://www.googleapis.com/auth/tasks (read + write)If token.json doesn't exist:
credentials.json) - See setup.mdtoken.json📋 Your Google Tasks:
📌 List Name
──────────────────────────────────────────────────
1. ⬜ Task title (due: YYYY-MM-DD)
Note: Task notes if present
2. ⬜ Another task
📌 Another List
──────────────────────────────────────────────────
(no tasks)
token.json - Access/refresh tokens (workspace root)google-tasks-config.sh - Configuration file (default list setting)scripts/get_tasks.sh - Bash script to view tasksscripts/create_task.sh - Bash script to create tasksscripts/delete_task.sh - Bash script to delete tasksreferences/setup.md - Detailed setup guideThe bash script uses:
curl for HTTP requestsjq for JSON parsingtoken.jsonNo Python dependencies required.
Token expired:
Error: Invalid credentials
Delete token.json and re-authenticate.
Missing jq: