Documentation

Complete documentation for gtasks — the Google Tasks CLI tool.

gtasks is a CLI tool for managing your Google Tasks. Any tasks you add here will be instantly available in all your Google apps such as mail, calendar, and tasks android app.

It is written in Go and shipped as a nifty binary. All the major commands have been listed below. If you find any problems with the tool, please open an issue on GitHub.

Installation

Install gtasks via curl, go install, or manual binary download. Available for macOS, Linux, and Windows.

Logging In

Authenticate gtasks with your Google account using OAuth2. Token stored securely in system keyring.

Tasklist commands

View, create, update, and delete Google Task lists from the terminal with gtasks.

Task commands

View, add, complete, undo, update, and delete tasks with gtasks. Full command reference with examples.

Configuration

Configure gtasks with a config file, environment variables, or build-time flags. Supports TOML, YAML, and JSON.

AI Agent Skills

Use gtasks with Claude Code, Codex, and other AI agents. Install skill files for natural language task management.