ClickUp CLI Skill

Manage ClickUp tasks and time entries from the command line. Full CRUD for tasks, subtasks, and time tracking.

When to Use

Use /clickup when:

• Managing tasks (search, create, update, delete)
• Tracking time (add entries, view reports, fix dates)
• Viewing weekly time reports
• Finding task or member IDs

Quick Start

cd <skill-directory>

# Setup (first time only)
cp .env.example .env
# Add: CLICKUP_API_TOKEN, CLICKUP_WORKSPACE_ID, CLICKUP_USER_ID

# Run commands
npm run dev -- <command>

Essential Commands

Tasks

# Search tasks
npm run dev -- tasks search "billing" --assignee me --table

# Get task details
npm run dev -- tasks get PROJ-123 --full

# Update task
npm run dev -- tasks update PROJ-123 --status "complete"

Time Tracking

# Today's time
npm run dev -- time list

# Weekly report
npm run dev -- time report

# Add time entry
npm run dev -- time add PROJ-123 --duration "2h 30m" --date "2026-01-20"

# Move entry to different date
npm run dev -- time move <entry_id> --to "2026-01-21"

# Update entry
npm run dev -- time update <entry_id> --duration "3h"

# Delete entry
npm run dev -- time delete <entry_id> --force

Utilities

# Find your user ID
npm run dev -- members find "your@email.com"

# List workspaces
npm run dev -- workspaces list

# Show config
npm run dev -- config show

Output Formats

All commands support:

• Default: Human-readable
• --table: Tabular format
• --json: JSON output

Configuration

Required in .env:

CLICKUP_API_TOKEN=pk_your_token_here
CLICKUP_WORKSPACE_ID=your_workspace_id
CLICKUP_USER_ID=your_user_id
CLICKUP_TEAM_ID=your_team_id

Get your API token: ClickUp Settings → Apps → API Token

Reference Documentation

• Full Command Reference - All commands and options
• Time Tracking Guide - Workflows and reports
• Troubleshooting - Common issues

Development

npm install     # Install deps
npm run build   # Compile TypeScript
npm run dev     # Run without building
npm test        # Run tests