Skip to content

Command reference

All commands are invoked as subcommands of clickup. Run clickup --help for a summary, or clickup <command> --help for details on any command.

Every command that produces output supports --json for machine-readable output, --jq for inline filtering, and --template for Go template formatting.

Flag details, examples, and options for each command are in the auto-generated Reference pages.

Task management

CommandDescription
task activityView a task’s details and comment history
task createCreate a new ClickUp task
task deleteDelete one or more tasks
task editEdit a ClickUp task
task listList tasks in a ClickUp list
task list-addAdd tasks to an additional list
task list-removeRemove tasks from a list
task moveMove a task to a different list
task recentShow recently updated tasks
task searchSearch tasks by name and description
task viewView one or more ClickUp tasks

Dependencies & checklists

CommandDescription
task checklist addCreate a checklist on a task
task checklist itemManage checklist items
task checklist removeDelete a checklist
task dependency addAdd a dependency to a task
task dependency removeRemove a dependency from a task

Time tracking

CommandDescription
task time deleteDelete a time entry
task time listView time entries for a task or date range
task time logLog time to a task
task time runningShow the current running timer
task time startStart a time entry timer
task time stopStop the running timer

Docs

CommandDescription
doc createCreate a new ClickUp Doc
doc listList ClickUp Docs in the workspace
doc page createCreate a page in a ClickUp Doc
doc page editEdit a page in a ClickUp Doc
doc page listList pages in a ClickUp Doc
doc page viewView a page in a ClickUp Doc
doc viewView a ClickUp Doc

Status & fields

CommandDescription
field listList custom fields available in a list
status addAdd a new status to a space
status listList available statuses for a space
status setSet the status of a task
tag createCreate tags in a space
tag listList tags in a space

Attachments

CommandDescription
attachment addUpload file(s) to a task
attachment listList attachments on a task

Comments

CommandDescription
comment addAdd a comment to a task
comment deleteDelete a comment
comment editEdit a comment
comment listList comments on a task
comment replyReply to a comment thread

Git & GitHub integration

CommandDescription
link branchLink the current git branch to a ClickUp task
link commitLink a git commit to a ClickUp task
link prLink a GitHub PR to a ClickUp task
link syncSync ClickUp task info to a GitHub PR

Sprints

CommandDescription
sprint currentShow current sprint tasks
sprint listList sprints in a folder

Workspace

CommandDescription
inboxShow recent @mentions and assignments
member listList workspace members
space createCreate a new space
space deleteDelete a space
space listList spaces in your workspace
space selectSet default space

Setup & utilities

CommandDescription
auth loginAuthenticate with ClickUp
auth logoutLog out of ClickUp
auth statusShow authentication status
completionGenerate shell completion scripts
versionPrint the version of clickup CLI