← Back to home

Complete Reference

CU-CLI Documentation

All CLI commands, REST API endpoints, and MCP tools for the ClickUp CLI. Real examples, ready to copy.

CLI Commands REST API MCP Tools Installation

⚡ CLI Commands

cu create Create a task in a list

Creates a new task in a specified ClickUp list.

Usage

cu create "Task name" --list-id <id> [options]

Options

Flag	Description
--list-id *	List ID (required)
--priority	1=Urgent, 2=High, 3=Normal, 4=Low
--due-date	Unix timestamp
--assignee	User email or ID
--description	Task description

Example

cu create "Ship the prototype" --list-id 901415499626 --priority 2

cu list List tasks from a list

Lists all tasks in a specific ClickUp list.

Usage

cu list --list-id <id> [options]

Options

Flag	Description
--list-id *	List ID (required)
--status	Filter by status name
--assignee	Filter by assignee

Example

cu list --list-id 901415499626 --status open

cu find Search tasks across workspace

Searches for tasks matching a query string. Requires --team-id.

Usage

cu find --query <text> --team-id <id> [options]

Options

Flag	Description
--query *	Search query (required)
--team-id *	Workspace ID (required)
--list-id	Limit to specific list

Example

cu find --query "budget" --team-id 9014416713

cu task get Get task details

Retrieves full details for a specific task.

Usage

cu task get <task-id>

Example

cu task get 86b9e64ww

cu task update Update task properties

Modifies properties of an existing task.

Usage

cu task update <task-id> [options]

Options

Flag	Description
--name	New task name
--status	New status
--priority	New priority (1-4)
--description	New description

Example

cu task update 86b9e64ww --status "in progress" --priority 1

cu task delete Delete a task

Permanently deletes a task from ClickUp.

Usage

cu task delete <task-id> [--force]

Example

cu task delete 86b9e64wx --force

cu workspace list List all workspaces

Lists all ClickUp workspaces accessible with the API token.

Usage

cu workspace list

Example

cu workspace list

cu workspace members List workspace members

Lists all members in a workspace.

Usage

cu workspace members --team-id <id>

Example

cu workspace members --team-id 9014416713

cu space list List spaces in workspace

Lists all spaces in a workspace.

Usage

cu space list --team-id <id>

Example

cu space list --team-id 9014416713

cu space folders List folders in a space

Lists all folders within a space.

Usage

cu space folders <space-id>

Example

cu space folders 90141890182

cu space lists List lists in a folder

Lists all lists within a folder.

Usage

cu space lists <folder-id>

Example

cu space lists 90142373755

cu space create Create a new space

Creates a new space within a workspace.

Usage

cu space create --team-id <id> --name "<name>"

Example

cu space create --team-id 9014416713 --name "Q4 Projects"

cu space update Update a space

Updates a space name.

Usage

cu space update --space-id <id> --name "<name>"

Example

cu space update --space-id 90141890182 --name "Renamed Space"

cu space delete Delete a space

Permanently deletes a space and all its folders and lists.

Usage

cu space delete --space-id <id>

Example

cu space delete --space-id 90141890182

📁 Folder Commands

cu folder create Create a folder in a space

Creates a new folder within a space.

Usage

cu folder create --space-id <id> --name "<name>"

Example

cu folder create --space-id 90141539665 --name "Active Projects"

cu folder get Get a folder by ID

Retrieves details for a specific folder.

Usage

cu folder get --folder-id <id>

Example

cu folder get --folder-id 90142373755

cu folder update Update a folder

Updates a folder name.

Usage

cu folder update --folder-id <id> --name "<name>"

Example

cu folder update --folder-id 90142373755 --name "Renamed Folder"

cu folder delete Delete a folder

Permanently deletes a folder and all its lists.

Usage

cu folder delete --folder-id <id>

Example

cu folder delete --folder-id 90142373755

cu list-create Create a new list

Creates a new list within a space.

Usage

cu list-create --name "<name>" --space-id <id>

Example

cu list-create --name "Sprint 1" --space-id 90141890182

cu list-delete Delete a list

Permanently deletes a list from ClickUp.

Usage

cu list-delete --list-id <id> [--force]

Example

cu list-delete --list-id 901415499626 --force

cu comment add Add a comment to a task

Adds a comment to an existing task.

Usage

cu comment add <task-id> --message "<text>"

Example

cu comment add 86b9e64ww --message "All systems nominal"

cu comment list List comments on a task

Retrieves all comments from a task.

Usage

cu comment list <task-id>

Example

cu comment list 86b9e64ww

cu tag add Add a tag to a task

Applies an existing tag to a task.

Usage

cu tag add <task-id> --tag <name>

Example

cu tag add 86b9e64ww --tag urgent

cu tag remove Remove a tag from a task

Removes a tag from a task.

Usage

cu tag remove <task-id> --tag <name>

Example

cu tag remove 86b9e64ww --tag urgent

cu move Move a task to another list

Moves a task to a new list.

Usage

cu move <task-id> --list-id <id>

Example

cu move 86b9e64ww --list-id 901403974772

cu info time Time in status for a task

Returns time tracking data showing how long the task has been in each status.

Usage

cu info time <task-id>

Example

cu info time 86b9e64ww

cu view list List views in a space or folder

Lists all views available in a space or folder.

Usage

cu view list <space-id-or-folder-id>

Example

cu view list 90141890182

cu view team List workspace views

Lists all views available in a workspace.

Usage

cu view team --team-id <id>

Example

cu view team --team-id 9014416713

🔌 REST API Endpoints

Base URL: https://api.clickup.com/api/v2

GET /team

List all workspaces

GET /team/{team_id}

Get workspace info + members

GET /team/{team_id}/space

List spaces in workspace

GET /space/{space_id}/folder

List folders in space

GET /space/{space_id}/list

List lists in space

GET /folder/{folder_id}/list

List lists in folder

GET /list/{list_id}/task

List tasks in list

GET /task/{task_id}

Get task details

POST /list/{list_id}/task

Create task

PUT /task/{task_id}

Update task

DELETE /task/{task_id}

Delete task (returns 204 No Content)

POST /list/{list_id}/task/{task_id}/comment

Add comment to task

GET /task/{task_id}/comment

List task comments

POST /task/{task_id}/tag/{tag_name}

Add tag to task

DELETE /task/{task_id}/tag/{tag_name}

Remove tag from task

GET /task/{task_id}/time

Get time in status

🔗 MCP Tools ClickUp MCP Server

MCP (Model Context Protocol) commands call the ClickUp MCP Server for extended capabilities including workspace-wide search, bulk operations, task linking, and dependencies.

cu mcp list-tools Discovery

Lists all available MCP tools from the ClickUp MCP Server.

Example

cu mcp list-tools

cu mcp search-workspace Search

Search across entire workspace — tasks, lists, folders, docs.

Usage

cu mcp search-workspace --query "<text>"

Example

cu mcp search-workspace --query "Q4 Marketing Launch"

cu mcp search-tasks-by-type Search

Filter tasks by task type.

Usage

cu mcp search-tasks-by-type --type <type>

Example

cu mcp search-tasks-by-type --type "bug"

cu mcp search-tasks-by-tag Search

Filter tasks by tag name.

Usage

cu mcp search-tasks-by-tag --tag <name>

Example

cu mcp search-tasks-by-tag --tag "ux-quality"

cu mcp create-task Create

Create a task via MCP — supports more fields than the base create command.

Usage

cu mcp create-task --list-id <id> --name "<text>" [options]

Options

Flag	Description
--list-id *	Target list ID
--name *	Task name
--description	Task description
--assignee	Assignee email
--due-date	Due date (Unix timestamp)
--priority	1=Urgent, 2=High, 3=Normal, 4=Low

Example

cu mcp create-task --list-id 901415499626 --name "Draft blog post" --assignee "brian@logikwise.com" --priority 2

cu mcp get-task Read

Get full task details including custom fields.

Usage

cu mcp get-task <task-id>

Example

cu mcp get-task 86b9e64ww

cu mcp update-task Update

Update task properties — status, name, priority, description, assignees.

Usage

cu mcp update-task --task-id <id> [options]

Options

Flag	Description
--task-id *	Task ID
--status	New status
--name	New name
--priority	New priority
--description	New description

Example

cu mcp update-task --task-id 86b9e64ww --status "In Progress" --priority 1

cu mcp delete-task Delete

Delete a task or subtask permanently.

Usage

cu mcp delete-task --task-id <id>

Example

cu mcp delete-task --task-id 86b9e64wx

cu mcp set-custom-fields Update

Set custom field values on a task.

Usage

cu mcp set-custom-fields --task-id <id> --fields '[{"id":"<field-id>","value":"<val>"}]'

Example

cu mcp set-custom-fields --task-id 86b9e64ww --fields '[{"id":"abc123","value":"4.07"}]'

cu mcp create-bulk-tasks Bulk

Create multiple tasks in a single API call.

Usage

cu mcp create-bulk-tasks --list-id <id> --tasks '[{"name":"Task 1"},{"name":"Task 2"}]'

Example

cu mcp create-bulk-tasks --list-id 901415499626 --tasks '[{"name":"Send welcome email"},{"name":"Schedule orientation"},{"name":"Set up hardware"}]'

cu mcp update-bulk-tasks Bulk

Update multiple tasks at once — status, assignee, due date.

Usage

cu mcp update-bulk-tasks --task-ids '["id1","id2"]' --updates '{"status":"In Review"}'

Example

cu mcp update-bulk-tasks --task-ids '["86b9e64ww","86b9e64wx"]' --updates '{"status":"Done"}'

cu mcp get-comments Read

Get all comments on a task.

Usage

cu mcp get-comments --task-id <id>

Example

cu mcp get-comments --task-id 86b9e64ww

cu mcp get-threaded-replies Read

Get threaded replies under a parent comment.

Usage

cu mcp get-threaded-replies --task-id <id> --comment-id <id>

Example

cu mcp get-threaded-replies --task-id 86b9e64ww --comment-id 90140195821176

cu mcp add-comment Write

Add a comment to a task. Can @mention team members.

Usage

cu mcp add-comment --task-id <id> --message "<text>" [--mention <user-id>]

Example

cu mcp add-comment --task-id 86b9e64ww --message "@Mark, can you please provide the latest mockups?"

cu mcp add-tag Write

Apply an existing tag to a task.

Usage

cu mcp add-tag --task-id <id> --tag <name>

Example

cu mcp add-tag --task-id 86b9e64ww --tag "urgent"

cu mcp remove-tag Write

Remove a tag from a task.

Usage

cu mcp remove-tag --task-id <id> --tag <name>

Example

cu mcp remove-tag --task-id 86b9e64ww --tag "backend"

cu mcp move-task Write

Move a task to a new list.

Usage

cu mcp move-task --task-id <id> --list-id <id>

Example

cu mcp move-task --task-id 86b9e64ww --list-id 901403974772

cu mcp add-task-link Relations

Link two tasks together.

Usage

cu mcp add-task-link --task-id <id> --linked-task-id <id> --link-type <type>

Example

cu mcp add-task-link --task-id 86b9e64ww --linked-task-id 86b9e64wx --link-type "blocks"

cu mcp remove-task-link Relations

Remove a link between two tasks.

Usage

cu mcp remove-task-link --task-id <id> --linked-task-id <id>

cu mcp add-dependency Relations

Create a dependency relationship between tasks (blocking/blocked-by).

Usage

cu mcp add-dependency --task-id <id> --dependency-task-id <id>

Example

cu mcp add-dependency --task-id 86b9e64ww --dependency-task-id 86b9e64wx

cu mcp remove-dependency Relations

Remove a dependency between two tasks.

Usage

cu mcp remove-dependency --task-id <id> --dependency-task-id <id>

⚙️ Installation

pip

pip install cu-cli

Homebrew

brew install logikwise/tap/cu-cli

Set your API key

export CLICKUP_API_KEY=pk_90097854_YOUR_KEY_HERE

Or use --api-key flag

cu workspace list --api-key pk_90097854_YOUR_KEY_HERE