---
name: gog-tasks
description: "Google Tasks via the gog CLI: list task lists and tasks, add/update tasks, mark done/undo, delete, clear completed, and manage task lists. Use for to-do automation with JSON output."
---

# gog tasks

Tasks reads and writes with parseable output. Pick the account on every call
with `--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com tasks lists list --json
gog --account you@example.com tasks list --json --wrap-untrusted
gog --account you@example.com tasks get <taskId> --json --wrap-untrusted
```

## Writes

```bash
gog --account you@example.com tasks add "Write report" --due 2026-06-15 --json
gog --account you@example.com tasks update <taskId> --title "..."
gog --account you@example.com tasks done <taskId>
gog --account you@example.com tasks undo <taskId>
gog --account you@example.com tasks delete <taskId> --force
gog --account you@example.com tasks clear --force          # remove completed tasks
gog --account you@example.com tasks lists create --title "Project"
```

## Safety

- `delete` and `clear` remove tasks irreversibly and need `--force`; `clear`
  drops all completed tasks in a list.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

`gog tasks --help` · `gog tasks <cmd> --help` · `gog schema tasks <cmd> --json`
Reference: <https://gogcli.sh/>
