// open source — MIT — latest

gtasks
Google Tasks,
in your terminal.

Manage Google Tasks from the terminal. View, add, complete, and delete tasks with one command. Works with Claude Code, Codex, and other AI agents.

Get started GitHub
$ curl -fsSL https://gtasks.sidv.dev/install | bash
# why gtasks
01 /

One command. Done.

View, add, complete, delete. No browser tab, no context switch. Just your terminal.

02 /

AI agents speak gtasks

Ships with skill files for Claude Code, Codex, and OpenClaw. Your agent can manage tasks without extra setup.

03 /

Real Google Tasks sync

Official API. Changes appear in Gmail, Calendar, and the mobile app the moment you run the command.

04 /

Layered config

Flags beat env vars beat config file. TOML, YAML, or JSON — use whatever fits your workflow.

05 /

Single binary

No runtime. No deps. macOS, Linux, Windows. curl-install or go install — done in 10 seconds.

06 /

Keyring auth

OAuth2 + PKCE. Token lives in macOS Keychain, Linux Secret Service, or Windows Credential Manager.

# ai-first

Let your agent
handle the list

gtasks embeds skill files for Claude Code, Codex, and OpenClaw. Install once, then ask in plain English.

  • 01 Install gtasks and run gtasks login
  • 02 Run gtasks skills install to register the skill
  • 03 Ask Claude: "add deploy v2 to Work list, due Friday"
  • 04 Agent runs the command. Task syncs to Google.
claude code
❯ add task: deploy v2 due friday # using gtasks skill... $ gtasks tasks add \   -l "Work" -t "deploy v2" -d "friday" ✓ Task added to Work Done. "deploy v2" added, due Friday. ❯ what's due this week? $ gtasks tasks view \   -l "Work" --sort due Wed team sync Fri deploy v2 2 tasks this week: team sync Wed, deploy v2 Fri.
# install

Up in 60 seconds.

# installs to ~/.local/bin
curl -fsSL https://gtasks.sidv.dev/install | bash

# custom location
INSTALL_DIR=/usr/local/bin curl -fsSL https://gtasks.sidv.dev/install | bash
# requires Go 1.21+
go install github.com/BRO3886/gtasks@latest
# download the tarball for your platform from GitHub Releases
# e.g. gtasks_mac_arm64_vX.Y.Z.tar.gz, then:
tar -xzf gtasks_*.tar.gz
mv gtasks ~/.local/bin/
gtasks --version
# faq

Common questions.

What is gtasks? +
A CLI for Google Tasks. View, add, complete, and delete tasks from your terminal. All changes sync to Gmail, Google Calendar, and the mobile Tasks app instantly.
How do I install it? +
Fastest: curl -fsSL https://gtasks.sidv.dev/install | bash. Also available via go install github.com/BRO3886/gtasks@latest or as a binary from GitHub Releases.
How does authentication work? +
Run gtasks login. A browser opens for Google OAuth2 (PKCE flow). Your token goes into the system keyring — macOS Keychain, Linux Secret Service, Windows Credential Manager. Nothing written to plaintext.
macOS, Linux, Windows? +
Yes. Single static binary for each. macOS Intel and Apple Silicon, Linux amd64 and arm64, Windows. No runtime, no dependencies.
How do AI agents use gtasks? +
Run gtasks skills install (Claude Code), gtasks skills install --agent codex (Codex), or gtasks skills install --agent openclaw (OpenClaw). The embedded skill file teaches the agent every command. After that, just ask in plain English.
Does it sync with Google? +
Uses the official Google Tasks API. Every add, complete, or delete syncs immediately and shows up everywhere Google surfaces tasks.
Is it open source? +
MIT license. github.com/BRO3886/gtasks. Issues and PRs welcome.