Documentation
Complete documentation for gtasks, the Go-based Google Tasks CLI: installation, OAuth2 login, and commands to manage task lists and tasks from the terminal.
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 over OAuth2. Set client credentials via environment variables or a config file; tokens stay in the system keyring.
Tasklist commands
Manage Google task lists from the terminal with gtasks: view, create, update, and delete tasklists, and see inline help for every tasklist command you can run.
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.