Google Tasks CLI

gtasks: A CLI Tool for Google Tasks

---

Docs

Refer to the docs website to read about available commands.

Instructions to install

1. Download the binary for your system (check releases)
2. Move to a particular folder, for eg Documents
3. Append the absolute path (use pwd) of the folder to PATH
4. Execute gtasks from anywhere

Instructions to install using go install

Warning

Installing via go install is currently not working. Will be fixed soon.

go install github.com/BRO3886/gtasks@latest

Instructions to Run and Build from Source:

Prerequisites

• Go 1.24+
• Google Cloud Console OAuth2 credentials (see Configuration section)

Setup

1. Clone the repository:

git clone https://github.com/BRO3886/gtasks
cd gtasks

2. Create a .env file with your OAuth2 credentials:

# .env
GTASKS_CLIENT_ID=your-client-id.apps.googleusercontent.com
GTASKS_CLIENT_SECRET=your-client-secret

Build Commands

# Development build (uses .env file)
make dev

# Build for specific platforms
make linux    # Linux (amd64 + arm64)
make windows  # Windows (amd64)
make mac      # macOS (amd64 + arm64)

# Build for all platforms
make all

# Create release packages
make release

Configuration

To use GTasks, you need to set up Google OAuth2 credentials:

1. Go to Google Cloud Console

2. Create a new project or select existing one

3. Enable the Google Tasks API

4. Create OAuth2 credentials:

   • Application type: "Desktop application"
   • Add authorized redirect URIs:
     • http://localhost:8080/callback
     • http://localhost:8081/callback
     • http://localhost:8082/callback
     • http://localhost:9090/callback
     • http://localhost:9091/callback

5. Set environment variables:

export GTASKS_CLIENT_ID="your-client-id.apps.googleusercontent.com"
export GTASKS_CLIENT_SECRET="your-client-secret"

Or create a .env file (for building from source).

Token Storage

GTasks stores authentication tokens in ~/.gtasks/token.json. This directory is created automatically on first login.

• Usage

Usage:
  gtasks [command]

Available Commands:
  help        Help about any command
  login       Logging into Google Tasks
  tasklists   View and create tasklists for currently signed-in account
  tasks       View, create, list and delete tasks in a tasklist

Flags:
  -h, --help     help for gtasks
  -t, --toggle   Help message for toggle

Use "gtasks [command] --help" for more information about a command.

Commands

Help

• To see details about a command

gtasks <COMMAND> help

Auth

• Login

gtasks login

• Logout

gtasks logout

Tasklists

• Viewing Tasklists

gtasks tasklists view

• Creating a Tasklist

gtasks tasklists add -t 'title'
gtasks tasklists add --title 'title'

• Deleting a Tasklist

gtasks tasklists rm

Tasks

• To pre-select tasklist, provide it's title as follows:

gtasks tasks -l <title> subcommand [--subcommand-flags]

Examples:

gtasks tasks [--tasklist|-l] "DSC VIT" view [--include-completed | -i]

Note: If the -l flag is not provided you will be able to choose a tasklist from the prompt

• Viewing tasks

gtasks tasks view

• Include completed tasks

gtasks tasks view -i
gtasks tasks view --include-completed

• Sort options

gtasks tasks view ... --sort [due,title,position, default=position]

• Adding a task

gtasks tasks add

• Mark task as completed

gtasks tasks done

• Deleting a task

gtasks tasks rm

Made with ☕ & Cobra