name	clickup
description	ClickUp project management CLI. Full CRUD for tasks and time entries. Search, filter, view time reports. Use `/clickup` for task management and time tracking.

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