Operate Google Tasks with gog CLI.
Execution path: gog
Authenticated account: (account authenticated with gog)
Execution Notes
execWhen executing with the tool,timeout: 60specify
Task list management
List task lists
gog tasks lists list
gog tasks lists list --json
Create task list
gog tasks lists create --title "新しいリスト"
Delete task list
gog tasks lists delete <tasklistId>
List tasks
Get tasks in a list
gog tasks list <tasklistId>
gog tasks list <tasklistId> --max 20
Get including completed
gog tasks list <tasklistId> --show-completed
Only tasks with due dates
gog tasks list <tasklistId> --due-min "2026-02-01" --due-max "2026-02-28"
Add task
Basic
gog tasks add <tasklistId> --title "やること"
With details
gog tasks add <tasklistId> \
--title "報告書を作成" \
--notes "月次報告書\n- 売上データ\n- 顧客分析"
With due date
gog tasks add <tasklistId> \
--title "請求書送付" \
--due "2026-02-15"
Full option
gog tasks add <tasklistId> \
--title "プロジェクト計画書作成" \
--notes "第1四半期の計画をまとめる" \
--due "2026-02-20"
Get task details
gog tasks get <tasklistId> <taskId>
Update task
Change title
gog tasks update <tasklistId> <taskId> --title "新しいタイトル"
Add notes
gog tasks update <tasklistId> <taskId> --notes "追加メモ"
Change due date
gog tasks update <tasklistId> <taskId> --due "2026-02-28"
Complete task
Mark as completed
gog tasks done <tasklistId> <taskId>
Mark as incomplete
gog tasks undo <tasklistId> <taskId>
Delete task
Delete single
gog tasks delete <tasklistId> <taskId>
Clear all completed
gog tasks clear <tasklistId>
Additional options list
| Option | Description |
|---|---|
--title |
Task title |
--notes |
Notes/details |
--due |
Due date (YYYY-MM-DD format) |
List options
| Option | Description |
|---|---|
--max N |
Max N items |
--show-completed |
Show completed too |
--due-min |
Due start date |
--due-max |
Due end date |
Output options
| Option | Description |
|---|---|
--json |
JSON output |
--plain |
TSV output |
Getting task list IDs
# リスト一覧からIDを取得
gog tasks lists list --json | jq '.[].id'
The default task list is usually @default or the first list ID.
Typical workflow
Check task list → add new → complete
# 1. リスト確認
RESULT=$(gog tasks lists list --json)
LIST_ID=$(echo "$RESULT" | jq -r '.[0].id')
# 2. タスク一覧
gog tasks list "$LIST_ID"
# 3. タスク追加
gog tasks add "$LIST_ID" --title "緊急: クライアントに連絡" --due "2026-02-05"
# 4. 完了後
gog tasks done "$LIST_ID" "<taskId>"
Check tasks due this week
LIST_ID="<tasklistId>"
gog tasks list "$LIST_ID" --due-min "2026-02-04" --due-max "2026-02-10"
Clean up completed
gog tasks clear "$LIST_ID"
Notes
- Due date format:
YYYY-MM-DD(no time) - Subtask: Sub-task hierarchy management is limited in gog CLI
- Completed tasks: Hidden by default,
--show-completedto show - clear: Deletes only completed tasks (incomplete ones remain)