gtasks-cli

name	gtasks-cli
description	Manage Google Tasks from the command line - view, create, update, delete tasks and task lists. Use when the user asks to interact with Google Tasks, manage to-do items, create task lists, mark tasks complete, or check their Google Tasks.
homepage	https://github.com/BRO3886/gtasks
license	MIT
compatibility	Requires gtasks CLI tool to be installed and authenticated
metadata	{"author":"BRO3886","version":"1.0"}
required-env	[{"name":"GTASKS_CLIENT_ID","description":"Google OAuth2 client ID — can also be set in config file under [credentials]"},{"name":"GTASKS_CLIENT_SECRET","description":"Google OAuth2 client secret — can also be set in config file under [credentials]"}]
allowed-tools	Bash(gtasks:*)

Google Tasks CLI Skill

This skill enables you to manage Google Tasks directly from the command line using the gtasks CLI tool.

It can also be installed into supported AI agent skill directories with the built-in gtasks skills commands.

Prerequisites

Before using any commands, ensure the following requirements are met:

1. GTasks Installation

Check if gtasks is installed on the system:

# Cross-platform check (works on macOS, Linux, Windows Git Bash)
gtasks --version 2>/dev/null || gtasks.exe --version 2>/dev/null || echo "gtasks not found"

# Or use which/where commands
# macOS/Linux:
which gtasks

# Windows (Command Prompt):
where gtasks

# Windows (PowerShell):
Get-Command gtasks

If gtasks is not installed:

macOS/Linux (recommended):

curl -fsSL https://gtasks.sidv.dev/install | bash

Installs to ~/.local/bin by default. Set INSTALL_DIR to override:

INSTALL_DIR=/usr/local/bin curl -fsSL https://gtasks.sidv.dev/install | bash

Manual install:

1. Download the binary for your system from GitHub Releases
2. Move to a directory in your PATH (e.g. ~/.local/bin or /usr/local/bin)
3. chmod +x gtasks

Windows: Download the binary from GitHub Releases and add to PATH.

Verify installation: gtasks --version

IMPORTANT for Agents: Always check if gtasks is installed before attempting to use it. If the command is not found, inform the user and provide installation instructions.

2. Environment Variables

Set up Google OAuth2 credentials as environment variables:

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