google-tasks

# Google Tasks Skill

Manage Google Tasks from all task lists using lightweight bash scripts.

## Quick Start

### View tasks
```bash
bash scripts/get_tasks.sh
```

### Create a task
```bash
# Using default list (configured in google-tasks-config.sh)
bash scripts/create_task.sh "Task title" ["due-date"] ["notes"]

# Specifying list name
bash scripts/create_task.sh "List Name" "Task title" ["due-date"] ["notes"]
```

Examples:
```bash
# Simple task (uses default list)
bash scripts/create_task.sh "Buy groceries"

# Task with due date (uses default list)
bash scripts/create_task.sh "Finish report" "2026-02-10"

# Task with specific list
bash scripts/create_task.sh "Work" "Finish report" "2026-02-10"

# Task with list, due date, and notes
bash scripts/create_task.sh "Personal" "Call mom" "2026-02-05" "Ask about her health"
```

**Default list configuration:**
Edit `google-tasks-config.sh` to set your default list:
```bash
DEFAULT_LIST="Private"  # Change to your preferred default
```

### Delete a task
```bash
bash scripts/delete_task.sh "List Name" <task-number-or-title>
```

Examples:
```bash
# Delete by task number (position in list)
bash scripts/delete_task.sh "Work" 2

# Delete by task title
bash scripts/delete_task.sh "Inbox" "Buy groceries"
```

## Requirements

- `jq` - JSON processor (usually pre-installed)
- `curl` - HTTP client (usually pre-installed)
- Valid `token.json` with OAuth access token
- **Scopes required:** `https://www.googleapis.com/auth/tasks` (read + write)

## First-Time Setup

If `token.json` doesn't exist:

1. User needs OAuth credentials (`credentials.json`) - See [setup.md](references/setup.md)
2. Run the Node.js authentication flow first to generate `token.json`
3. Then the bash script can be used for all subsequent calls

## Output Format

```
📋 Your Google Tasks:

📌 List Name
──────────────────────────────────────────────────
  1. ⬜ Task title (due: YYYY-MM-DD)
     Note: Task notes if present
  2. ⬜ Another task

📌 Another List
──...

# Google Tasks Skill for OpenClaw

Manage your Google Tasks directly from OpenClaw using lightweight bash scripts with OAuth authentication.

## Features

- ✅ **View all tasks** across all your Google Task lists
- ✅ **Create new tasks** with optional due dates and notes
- ✅ **Delete tasks** by number or title
- ✅ **Automatic token refresh** - no re-authentication needed
- ✅ **Lightweight** - Pure bash with curl and jq
- ✅ **Configurable** - Set your default task list

## Quick Start

### View your tasks
```bash
bash scripts/get_tasks.sh
```

### Create a task
```bash
# Simple task (uses default list from config)
bash scripts/create_task.sh "Buy groceries"

# Task with due date
bash scripts/create_task.sh "Finish report" "2026-02-10"

# Task in specific list
bash scripts/create_task.sh "Work" "Finish report" "2026-02-10"

# Task with notes
bash scripts/create_task.sh "Personal" "Call mom" "2026-02-05" "Ask about her health"
```

### Delete a task
```bash
# By position in list
bash scripts/delete_task.sh "Work" 2

# By task title
bash scripts/delete_task.sh "Inbox" "Buy groceries"
```

## Setup

1. **Install dependencies:**
   - `jq` (JSON processor) - usually pre-installed
   - `curl` (HTTP client) - usually pre-installed
   - Node.js packages: `npm install`

2. **Get OAuth credentials:**
   - Follow the guide in [references/setup.md](references/setup.md)
   - Download `credentials.json` from Google Cloud Console
   - Add required scope: `https://www.googleapis.com/auth/tasks`

3. **Authenticate:**
   - Run the initial authentication to generate `token.json`
   - The bash scripts will handle token refresh automatically

4. **Configure default list (optional):**
   - Edit `google-tasks-config.sh` to set your preferred default list

## File Structure

```
google-tasks/
├── SKILL.md                    # Skill metadata and documentation
├── README.md                   # This file
├── package.json                # Node.js dependencies for auth
├── google-tasks-confi...