Command-line interface for ClickUp project management. Manage tasks, spaces, lists, comments, and time tracking from your terminal.
brew tap builtbyrobben/tap
brew install clickup-cliDownload the latest release from GitHub Releases.
git clone https://github.com/builtbyrobben/clickup-cli.git
cd clickup-cli
make buildclickup-cli requires a ClickUp API key and a Team ID.
Environment variables (recommended for CI/scripts):
export CLICKUP_API_KEY="your-api-key"
export CLICKUP_TEAM_ID="your-team-id"Keyring + config storage (recommended for interactive use):
# Store API key in system keyring
clickup-cli auth set-key --stdin
# Store Team ID in config file
clickup-cli auth set-team YOUR_TEAM_ID| Variable | Description |
|---|---|
CLICKUP_API_KEY |
API key (overrides keyring) |
CLICKUP_TEAM_ID |
Team ID (overrides config file) |
CLICKUP_CLI_COLOR |
Color output: auto, always, never |
CLICKUP_CLI_OUTPUT |
Default output mode: json, plain |
| Flag | Description |
|---|---|
--json |
Output JSON to stdout (best for scripting) |
--plain |
Output stable, parseable text (TSV; no colors) |
--color |
Color output: auto, always, never |
--verbose |
Enable verbose logging |
--force |
Skip confirmations for destructive commands |
--no-input |
Never prompt; fail instead (useful for CI) |
Manage authentication credentials.
# Store API key in system keyring
clickup-cli auth set-key --stdin
# Store Team ID in config
clickup-cli auth set-team 1234567
# Check authentication status
clickup-cli auth status
# Remove stored credentials
clickup-cli auth removeCreate, read, update, and delete tasks.
# List tasks in a list
clickup-cli tasks list --list LIST_ID
# Filter by status or assignee
clickup-cli tasks list --list LIST_ID --status open
clickup-cli tasks list --list LIST_ID --assignee "John"
# Get a specific task
clickup-cli tasks get TASK_ID
# Create a task
clickup-cli tasks create LIST_ID "Fix login bug"
# Create with priority (1=urgent, 2=high, 3=normal, 4=low)
clickup-cli tasks create LIST_ID "Deploy v2" --priority 1
# Create with due date (unix ms)
clickup-cli tasks create LIST_ID "Write docs" --due 1700000000000
# Update a task
clickup-cli tasks update TASK_ID --status done
clickup-cli tasks update TASK_ID --name "New name" --priority 2
# Delete a task
clickup-cli tasks delete TASK_IDList spaces in your team.
# List all spaces
clickup-cli spaces list
# Output as JSON
clickup-cli spaces list --jsonList ClickUp lists within spaces or folders.
# List by space (shows folders + folderless lists)
clickup-cli lists list --space SPACE_ID
# List by folder
clickup-cli lists list --folder FOLDER_ID
# Output as JSON
clickup-cli lists list --space SPACE_ID --jsonList team members.
# List all team members
clickup-cli members list
# Output as JSON
clickup-cli members list --jsonManage task comments.
# List comments on a task
clickup-cli comments list TASK_ID
# Add a comment to a task
clickup-cli comments add TASK_ID "Looks good, deploying now"
# Output as JSON
clickup-cli comments list TASK_ID --jsonTrack time on tasks.
# Log time to a task (duration in milliseconds)
clickup-cli time log TASK_ID 3600000
# List time entries for a task
clickup-cli time list TASK_ID
# Output as JSON
clickup-cli time list TASK_ID --jsonPrint version information.
clickup-cli versionMIT