Can I use ClickUp as a CLI?

Yes. KosmoKrator exposes a ClickUp CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose ClickUp through MCP?

Yes. The KosmoKrator MCP gateway can expose selected ClickUp tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are ClickUp credentials stored?

ClickUp credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for ClickUp MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

ClickUp CLI for AI Agents

Use the ClickUp CLI from KosmoKrator to call ClickUp tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

34 functions 15 read 19 write API token auth

Submit ClickUp feedback View package source

ClickUp CLI Setup

ClickUp can be configured headlessly with `kosmokrator integrations:configure clickup`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure clickup --set api_token="$CLICKUP_API_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor clickup --json
kosmokrator integrations:status --json

Credentials

Authentication type: API token api_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_token`	`CLICKUP_API_TOKEN`	Secret `secret`	yes	API Token
`workspace_id`	`CLICKUP_WORKSPACE_ID`	Text `string`	no	Workspace ID

Call ClickUp Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call clickup.clickup_get_hierarchy '{
  "workspace_id": "example_workspace_id",
  "space_ids": "example_space_ids"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:clickup clickup_get_hierarchy '{
  "workspace_id": "example_workspace_id",
  "space_ids": "example_space_ids"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs clickup --json
kosmo integrations:docs clickup.clickup_get_hierarchy --json
kosmo integrations:schema clickup.clickup_get_hierarchy --json
kosmo integrations:search "ClickUp" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to ClickUp.

`clickup.clickup_get_hierarchy`

Read read

Get the ClickUp workspace hierarchy — spaces, folders, and lists. Returns a tree structure with IDs and names for navigation. Optionally filter to specific space IDs.

Parameters: workspace_id, space_ids

Generic CLI call

kosmo integrations:call clickup.clickup_get_hierarchy '{"workspace_id":"example_workspace_id","space_ids":"example_space_ids"}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_hierarchy '{"workspace_id":"example_workspace_id","space_ids":"example_space_ids"}' --json

`clickup.clickup_search`

Read read

Search tasks across the ClickUp workspace. Supports filtering by query, statuses, assignees, and more. Returns matching tasks with their details.

Parameters: query, statuses, assignees, include_closed, include_subtasks, page, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_search '{"query":"example_query","statuses":"example_statuses","assignees":"example_assignees","include_closed":true,"include_subtasks":true,"page":1,"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_search '{"query":"example_query","statuses":"example_statuses","assignees":"example_assignees","include_closed":true,"include_subtasks":true,"page":1,"workspace_id":"example_workspace_id"}' --json

`clickup.clickup_list_members`

Read read

Get all workspace members with their IDs, names, emails, and roles.

Parameters: none

Generic CLI call

kosmo integrations:call clickup.clickup_list_members '{}' --json

Provider shortcut

kosmo integrations:clickup clickup_list_members '{}' --json

`clickup.clickup_find_member`

Read read

Find a workspace member by name or email.

Parameters: query

Generic CLI call

kosmo integrations:call clickup.clickup_find_member '{"query":"example_query"}' --json

Provider shortcut

kosmo integrations:clickup clickup_find_member '{"query":"example_query"}' --json

`clickup.clickup_resolve_members`

Read read

Convert member names or emails to ClickUp user IDs for assigning tasks.

Parameters: query

Generic CLI call

kosmo integrations:call clickup.clickup_resolve_members '{"query":"example_query"}' --json

Provider shortcut

kosmo integrations:clickup clickup_resolve_members '{"query":"example_query"}' --json

`clickup.clickup_get_tasks`

Read read

Get all tasks in a ClickUp list. Supports filtering by statuses, assignees, and due dates. Use clickup_get_hierarchy first to find the list ID.

Parameters: list_id, statuses, assignees, due_date_gt, due_date_lt, include_closed, page

Generic CLI call

kosmo integrations:call clickup.clickup_get_tasks '{"list_id":"example_list_id","statuses":"example_statuses","assignees":"example_assignees","due_date_gt":"example_due_date_gt","due_date_lt":"example_due_date_lt","include_closed":true,"page":1}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_tasks '{"list_id":"example_list_id","statuses":"example_statuses","assignees":"example_assignees","due_date_gt":"example_due_date_gt","due_date_lt":"example_due_date_lt","include_closed":true,"page":1}' --json

`clickup.clickup_get_task`

Read read

Get a single ClickUp task by ID with full details. Supports both regular IDs and custom IDs (e.g., "DEV-42"). Optionally include subtask details.

Parameters: task_id, include_subtasks

Generic CLI call

kosmo integrations:call clickup.clickup_get_task '{"task_id":"example_task_id","include_subtasks":true}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_task '{"task_id":"example_task_id","include_subtasks":true}' --json

`clickup.clickup_create_task`

Write write

Create a new task in a ClickUp list. Requires a list ID and task name. Supports description, status, priority, assignees, dates, tags, and creating subtasks via parentTaskId. Use clickup_get_hierarchy to find list IDs.

Parameters: list_id, name, description, status, priority, assignees, due_date, start_date, tags, parent_task_id

Generic CLI call

kosmo integrations:call clickup.clickup_create_task '{"list_id":"example_list_id","name":"example_name","description":"example_description","status":"example_status","priority":1,"assignees":"example_assignees","due_date":"example_due_date","start_date":"example_start_date"}' --json

Provider shortcut

kosmo integrations:clickup clickup_create_task '{"list_id":"example_list_id","name":"example_name","description":"example_description","status":"example_status","priority":1,"assignees":"example_assignees","due_date":"example_due_date","start_date":"example_start_date"}' --json

`clickup.clickup_update_task`

Write write

Update an existing ClickUp task. Supports changing name, description, status, priority, assignees, and dates. Set status to "closed" to complete a task. Supports custom task IDs like "DEV-42".

Parameters: task_id, name, description, status, priority, assignees, remove_assignees, due_date, start_date, time_estimate

Generic CLI call

kosmo integrations:call clickup.clickup_update_task '{"task_id":"example_task_id","name":"example_name","description":"example_description","status":"example_status","priority":1,"assignees":"example_assignees","remove_assignees":"example_remove_assignees","due_date":"example_due_date"}' --json

Provider shortcut

kosmo integrations:clickup clickup_update_task '{"task_id":"example_task_id","name":"example_name","description":"example_description","status":"example_status","priority":1,"assignees":"example_assignees","remove_assignees":"example_remove_assignees","due_date":"example_due_date"}' --json

`clickup.clickup_delete_task`

Write write

Delete a ClickUp task permanently. Supports custom task IDs like "DEV-42". This action cannot be undone.

Parameters: task_id

Generic CLI call

kosmo integrations:call clickup.clickup_delete_task '{"task_id":"example_task_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_delete_task '{"task_id":"example_task_id"}' --json

`clickup.clickup_add_tag`

Write write

Add an existing tag to a ClickUp task. The tag must already exist in the space.

Parameters: task_id, tag_name

Generic CLI call

kosmo integrations:call clickup.clickup_add_tag '{"task_id":"example_task_id","tag_name":"example_tag_name"}' --json

Provider shortcut

kosmo integrations:clickup clickup_add_tag '{"task_id":"example_task_id","tag_name":"example_tag_name"}' --json

`clickup.clickup_remove_tag`

Write write

Remove a tag from a ClickUp task.

Parameters: task_id, tag_name

Generic CLI call

kosmo integrations:call clickup.clickup_remove_tag '{"task_id":"example_task_id","tag_name":"example_tag_name"}' --json

Provider shortcut

kosmo integrations:clickup clickup_remove_tag '{"task_id":"example_task_id","tag_name":"example_tag_name"}' --json

`clickup.clickup_attach_file`

Write write

Upload a local file attachment to a ClickUp task. ClickUp's official task attachment endpoint requires multipart file upload; cloud URL passthrough is not supported by this v2 endpoint.

Parameters: task_id, file_path, filename, file_url

Generic CLI call

kosmo integrations:call clickup.clickup_attach_file '{"task_id":"example_task_id","file_path":"example_file_path","filename":"example_filename","file_url":"example_file_url"}' --json

Provider shortcut

kosmo integrations:clickup clickup_attach_file '{"task_id":"example_task_id","file_path":"example_file_path","filename":"example_filename","file_url":"example_file_url"}' --json

`clickup.clickup_read_comments`

Read read

Get all comments on a ClickUp task. Supports pagination.

Parameters: task_id, start, start_id

Generic CLI call

kosmo integrations:call clickup.clickup_read_comments '{"task_id":"example_task_id","start":"example_start","start_id":"example_start_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_read_comments '{"task_id":"example_task_id","start":"example_start","start_id":"example_start_id"}' --json

`clickup.clickup_add_comment`

Write write

Add a new comment to a ClickUp task.

Parameters: task_id, comment_text, assignee, notify_all

Generic CLI call

kosmo integrations:call clickup.clickup_add_comment '{"task_id":"example_task_id","comment_text":"example_comment_text","assignee":"example_assignee","notify_all":true}' --json

Provider shortcut

kosmo integrations:clickup clickup_add_comment '{"task_id":"example_task_id","comment_text":"example_comment_text","assignee":"example_assignee","notify_all":true}' --json

`clickup.clickup_current_time_entry`

Read read

Get the currently running time tracking entry, if any.

Parameters: workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_current_time_entry '{"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_current_time_entry '{"workspace_id":"example_workspace_id"}' --json

`clickup.clickup_list_time_entries`

Read read

Get all time entries for a ClickUp task.

Parameters: task_id

Generic CLI call

kosmo integrations:call clickup.clickup_list_time_entries '{"task_id":"example_task_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_list_time_entries '{"task_id":"example_task_id"}' --json

`clickup.clickup_start_timer`

Write write

Start a time tracking timer on a ClickUp task.

Parameters: task_id, description, billable, tags, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_start_timer '{"task_id":"example_task_id","description":"example_description","billable":true,"tags":"example_tags","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_start_timer '{"task_id":"example_task_id","description":"example_description","billable":true,"tags":"example_tags","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_stop_timer`

Write write

Stop the currently running time tracking timer.

Parameters: workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_stop_timer '{"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_stop_timer '{"workspace_id":"example_workspace_id"}' --json

`clickup.clickup_log_time`

Write write

Add a manual time entry to a ClickUp task.

Parameters: task_id, start, duration, description, billable, tags, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_log_time '{"task_id":"example_task_id","start":"example_start","duration":"example_duration","description":"example_description","billable":true,"tags":"example_tags","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_log_time '{"task_id":"example_task_id","start":"example_start","duration":"example_duration","description":"example_description","billable":true,"tags":"example_tags","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_get_list`

Read read

Get details of a ClickUp list by ID.

Parameters: list_id

Generic CLI call

kosmo integrations:call clickup.clickup_get_list '{"list_id":"example_list_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_list '{"list_id":"example_list_id"}' --json

`clickup.clickup_create_list`

Write write

Create a new list in a ClickUp space.

Parameters: space_id, name, content, status

Generic CLI call

kosmo integrations:call clickup.clickup_create_list '{"space_id":"example_space_id","name":"example_name","content":"example_content","status":"example_status"}' --json

Provider shortcut

kosmo integrations:clickup clickup_create_list '{"space_id":"example_space_id","name":"example_name","content":"example_content","status":"example_status"}' --json

`clickup.clickup_create_list_in_folder`

Write write

Create a new list in a ClickUp folder.

Parameters: folder_id, name, content, status

Generic CLI call

kosmo integrations:call clickup.clickup_create_list_in_folder '{"folder_id":"example_folder_id","name":"example_name","content":"example_content","status":"example_status"}' --json

Provider shortcut

kosmo integrations:clickup clickup_create_list_in_folder '{"folder_id":"example_folder_id","name":"example_name","content":"example_content","status":"example_status"}' --json

`clickup.clickup_update_list`

Write write

Update a ClickUp list's name, content, or status.

Parameters: list_id, name, content, status

Generic CLI call

kosmo integrations:call clickup.clickup_update_list '{"list_id":"example_list_id","name":"example_name","content":"example_content","status":"example_status"}' --json

Provider shortcut

kosmo integrations:clickup clickup_update_list '{"list_id":"example_list_id","name":"example_name","content":"example_content","status":"example_status"}' --json

`clickup.clickup_get_folder`

Read read

Get details of a ClickUp folder by ID, including its lists.

Parameters: folder_id

Generic CLI call

kosmo integrations:call clickup.clickup_get_folder '{"folder_id":"example_folder_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_folder '{"folder_id":"example_folder_id"}' --json

`clickup.clickup_create_folder`

Write write

Create a new folder in a ClickUp space.

Parameters: space_id, name

Generic CLI call

kosmo integrations:call clickup.clickup_create_folder '{"space_id":"example_space_id","name":"example_name"}' --json

Provider shortcut

kosmo integrations:clickup clickup_create_folder '{"space_id":"example_space_id","name":"example_name"}' --json

`clickup.clickup_update_folder`

Write write

Update a ClickUp folder's name.

Parameters: folder_id, name

Generic CLI call

kosmo integrations:call clickup.clickup_update_folder '{"folder_id":"example_folder_id","name":"example_name"}' --json

Provider shortcut

kosmo integrations:clickup clickup_update_folder '{"folder_id":"example_folder_id","name":"example_name"}' --json

`clickup.clickup_list_channels`

Read read

List all chat channels in the ClickUp workspace.

Parameters: cursor, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_list_channels '{"cursor":"example_cursor","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_list_channels '{"cursor":"example_cursor","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_send_message`

Write write

Send a message to a ClickUp chat channel.

Parameters: channel_id, content, content_format, type, post_title, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_send_message '{"channel_id":"example_channel_id","content":"example_content","content_format":"example_content_format","type":"example_type","post_title":"example_post_title","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_send_message '{"channel_id":"example_channel_id","content":"example_content","content_format":"example_content_format","type":"example_type","post_title":"example_post_title","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_manage_document`

Write write

Create a ClickUp document in a space, folder, or list. Specify the parent container and visibility (PUBLIC or PRIVATE).

Parameters: name, parent_id, parent_type, visibility, create_page, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_manage_document '{"name":"example_name","parent_id":"example_parent_id","parent_type":"example_parent_type","visibility":"example_visibility","create_page":true,"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_manage_document '{"name":"example_name","parent_id":"example_parent_id","parent_type":"example_parent_type","visibility":"example_visibility","create_page":true,"workspace_id":"example_workspace_id"}' --json

`clickup.clickup_list_doc_pages`

Read read

List all pages in a ClickUp document.

Parameters: document_id, max_depth, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_list_doc_pages '{"document_id":"example_document_id","max_depth":1,"workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_list_doc_pages '{"document_id":"example_document_id","max_depth":1,"workspace_id":"example_workspace_id"}' --json

`clickup.clickup_get_doc_pages`

Read read

Get the content of specific pages from a ClickUp document.

Parameters: document_id, page_ids, content_format, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_get_doc_pages '{"document_id":"example_document_id","page_ids":"example_page_ids","content_format":"example_content_format","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_get_doc_pages '{"document_id":"example_document_id","page_ids":"example_page_ids","content_format":"example_content_format","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_create_doc_page`

Write write

Create a new page in a ClickUp document.

Parameters: document_id, name, content, content_format, sub_title, parent_page_id, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_create_doc_page '{"document_id":"example_document_id","name":"example_name","content":"example_content","content_format":"example_content_format","sub_title":"example_sub_title","parent_page_id":"example_parent_page_id","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_create_doc_page '{"document_id":"example_document_id","name":"example_name","content":"example_content","content_format":"example_content_format","sub_title":"example_sub_title","parent_page_id":"example_parent_page_id","workspace_id":"example_workspace_id"}' --json

`clickup.clickup_update_doc_page`

Write write

Update an existing page in a ClickUp document. Supports replace, append, or prepend content.

Parameters: document_id, page_id, name, content, content_format, edit_mode, sub_title, workspace_id

Generic CLI call

kosmo integrations:call clickup.clickup_update_doc_page '{"document_id":"example_document_id","page_id":"example_page_id","name":"example_name","content":"example_content","content_format":"example_content_format","edit_mode":"example_edit_mode","sub_title":"example_sub_title","workspace_id":"example_workspace_id"}' --json

Provider shortcut

kosmo integrations:clickup clickup_update_doc_page '{"document_id":"example_document_id","page_id":"example_page_id","name":"example_name","content":"example_content","content_format":"example_content_format","edit_mode":"example_edit_mode","sub_title":"example_sub_title","workspace_id":"example_workspace_id"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`clickup.clickup_get_hierarchy`

Get the ClickUp workspace hierarchy — spaces, folders, and lists. Returns a tree structure with IDs and names for navigation. Optionally filter to specific space IDs.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_hierarchy --json

Parameter	Type	Required	Description
`workspace_id`	string	no	Workspace/team ID. Uses configured default if omitted.
`space_ids`	string	no	Comma-separated space IDs to filter. Omit to get all spaces.

`clickup.clickup_search`

Search tasks across the ClickUp workspace. Supports filtering by query, statuses, assignees, and more. Returns matching tasks with their details.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_search --json

Parameter	Type	Required	Description
`query`	string	no	Search query to match task names.
`statuses`	string	no	Comma-separated statuses to filter by (e.g., "open,in progress").
`assignees`	string	no	Comma-separated assignee user IDs.
`include_closed`	boolean	no	Include closed tasks in results. Default: false.
`include_subtasks`	boolean	no	Include subtasks in results. Default: false.
`page`	integer	no	Page number for pagination (starts at 0).
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_list_members`

Get all workspace members with their IDs, names, emails, and roles.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_list_members --json

Parameter	Type	Required	Description
No parameters.

`clickup.clickup_find_member`

Find a workspace member by name or email.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_find_member --json

Parameter	Type	Required	Description
`query`	string	yes	Name or email to search for.

`clickup.clickup_resolve_members`

Convert member names or emails to ClickUp user IDs for assigning tasks.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_resolve_members --json

Parameter	Type	Required	Description
`query`	string	yes	Comma-separated names or emails to resolve to user IDs.

`clickup.clickup_get_tasks`

Get all tasks in a ClickUp list. Supports filtering by statuses, assignees, and due dates. Use clickup_get_hierarchy first to find the list ID.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_tasks --json

Parameter	Type	Required	Description
`list_id`	string	yes	List ID to get tasks from.
`statuses`	string	no	Comma-separated statuses to filter by.
`assignees`	string	no	Comma-separated assignee user IDs.
`due_date_gt`	string	no	Only tasks with due date after this (ISO 8601, e.g., "2026-01-01").
`due_date_lt`	string	no	Only tasks with due date before this (ISO 8601).
`include_closed`	boolean	no	Include closed tasks. Default: false.
`page`	integer	no	Page number for pagination (starts at 0).

`clickup.clickup_get_task`

Get a single ClickUp task by ID with full details. Supports both regular IDs and custom IDs (e.g., "DEV-42"). Optionally include subtask details.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_task --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports regular IDs or custom IDs like "DEV-42".
`include_subtasks`	boolean	no	Include subtask details. Default: false.

`clickup.clickup_create_task`

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_create_task --json

Parameter	Type	Required	Description
`list_id`	string	yes	List ID to create the task in.
`name`	string	yes	Task name.
`description`	string	no	Task description text.
`status`	string	no	Task status (must be valid for the list).
`priority`	integer	no	Priority: 1=urgent, 2=high, 3=normal, 4=low.
`assignees`	string	no	Comma-separated user IDs to assign. Use clickup_resolve_members to resolve names to IDs.
`due_date`	string	no	Due date in ISO 8601 format (e.g., "2026-03-15" or "2026-03-15T14:30:00").
`start_date`	string	no	Start date in ISO 8601 format.
`tags`	string	no	Comma-separated tag names. Tags must exist in the space.
`parent_task_id`	string	no	Parent task ID to create this as a subtask.

`clickup.clickup_update_task`

Update an existing ClickUp task. Supports changing name, description, status, priority, assignees, and dates. Set status to "closed" to complete a task. Supports custom task IDs like "DEV-42".

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_update_task --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID to update. Supports custom IDs like "DEV-42".
`name`	string	no	New task name.
`description`	string	no	New task description.
`status`	string	no	New status. Set to "closed" to complete the task.
`priority`	integer	no	Priority: 1=urgent, 2=high, 3=normal, 4=low.
`assignees`	string	no	Comma-separated user IDs to add as assignees.
`remove_assignees`	string	no	Comma-separated user IDs to remove as assignees.
`due_date`	string	no	New due date (ISO 8601). Empty string to clear.
`start_date`	string	no	New start date (ISO 8601). Empty string to clear.
`time_estimate`	integer	no	Time estimate in minutes.

`clickup.clickup_delete_task`

Delete a ClickUp task permanently. Supports custom task IDs like "DEV-42". This action cannot be undone.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_delete_task --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID to delete. Supports custom IDs like "DEV-42".

`clickup.clickup_add_tag`

Add an existing tag to a ClickUp task. The tag must already exist in the space.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_add_tag --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports custom IDs like "DEV-42".
`tag_name`	string	yes	Tag name to add.

`clickup.clickup_remove_tag`

Remove a tag from a ClickUp task.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_remove_tag --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports custom IDs like "DEV-42".
`tag_name`	string	yes	Tag name to remove.

`clickup.clickup_attach_file`

Upload a local file attachment to a ClickUp task. ClickUp's official task attachment endpoint requires multipart file upload; cloud URL passthrough is not supported by this v2 endpoint.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_attach_file --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID to attach the file to. Supports custom IDs like "DEV-42".
`file_path`	string	yes	Readable local file path to upload.
`filename`	string	no	Optional filename override for the uploaded attachment.
`file_url`	string	no	Deprecated. Public URL uploads are not supported by ClickUp v2 task attachments.

`clickup.clickup_read_comments`

Get all comments on a ClickUp task. Supports pagination.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_read_comments --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports custom IDs like "DEV-42".
`start`	string	no	Timestamp (ms) for pagination.
`start_id`	string	no	Comment ID for pagination.

`clickup.clickup_add_comment`

Add a new comment to a ClickUp task.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_add_comment --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports custom IDs like "DEV-42".
`comment_text`	string	yes	Comment text.
`assignee`	string	no	User ID to assign the comment to.
`notify_all`	boolean	no	Notify all assignees. Default: false.

`clickup.clickup_current_time_entry`

Get the currently running time tracking entry, if any.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_current_time_entry --json

Parameter	Type	Required	Description
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_list_time_entries`

Get all time entries for a ClickUp task.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_list_time_entries --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID. Supports custom IDs like "DEV-42".

`clickup.clickup_start_timer`

Start a time tracking timer on a ClickUp task.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_start_timer --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID to start the timer on.
`description`	string	no	Description for the time entry.
`billable`	boolean	no	Whether the time is billable.
`tags`	string	no	Comma-separated tag names for the time entry.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_stop_timer`

Stop the currently running time tracking timer.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_stop_timer --json

Parameter	Type	Required	Description
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_log_time`

Add a manual time entry to a ClickUp task.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_log_time --json

Parameter	Type	Required	Description
`task_id`	string	yes	Task ID.
`start`	string	yes	Start time in ISO 8601 format.
`duration`	string	yes	Duration in milliseconds.
`description`	string	no	Description for the time entry.
`billable`	boolean	no	Whether the time is billable.
`tags`	string	no	Comma-separated tag names for the time entry.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_get_list`

Get details of a ClickUp list by ID.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_list --json

Parameter	Type	Required	Description
`list_id`	string	yes	List ID.

`clickup.clickup_create_list`

Create a new list in a ClickUp space.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_create_list --json

Parameter	Type	Required	Description
`space_id`	string	yes	Space ID to create the list in.
`name`	string	yes	List name.
`content`	string	no	List description/content.
`status`	string	no	List status.

`clickup.clickup_create_list_in_folder`

Create a new list in a ClickUp folder.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_create_list_in_folder --json

Parameter	Type	Required	Description
`folder_id`	string	yes	Folder ID to create the list in.
`name`	string	yes	List name.
`content`	string	no	List description/content.
`status`	string	no	List status.

`clickup.clickup_update_list`

Update a ClickUp list's name, content, or status.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_update_list --json

Parameter	Type	Required	Description
`list_id`	string	yes	List ID.
`name`	string	no	New list name.
`content`	string	no	New list description/content.
`status`	string	no	New list status.

`clickup.clickup_get_folder`

Get details of a ClickUp folder by ID, including its lists.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_folder --json

Parameter	Type	Required	Description
`folder_id`	string	yes	Folder ID.

`clickup.clickup_create_folder`

Create a new folder in a ClickUp space.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_create_folder --json

Parameter	Type	Required	Description
`space_id`	string	yes	Space ID to create the folder in.
`name`	string	yes	Folder name.

`clickup.clickup_update_folder`

Update a ClickUp folder's name.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_update_folder --json

Parameter	Type	Required	Description
`folder_id`	string	yes	Folder ID.
`name`	string	yes	New folder name.

`clickup.clickup_list_channels`

List all chat channels in the ClickUp workspace.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_list_channels --json

Parameter	Type	Required	Description
`cursor`	string	no	Pagination cursor.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_send_message`

Send a message to a ClickUp chat channel.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_send_message --json

Parameter	Type	Required	Description
`channel_id`	string	yes	Channel ID.
`content`	string	yes	Message content, supports markdown.
`content_format`	string	no	Content format: "text/md" (default) or "text/plain".
`type`	string	no	Message type: "message" (default) or "post".
`post_title`	string	no	Post title (required if type is "post").
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_manage_document`

Create a ClickUp document in a space, folder, or list. Specify the parent container and visibility (PUBLIC or PRIVATE).

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_manage_document --json

Parameter	Type	Required	Description
`name`	string	yes	Document name/title.
`parent_id`	string	yes	ID of the parent container (space, folder, or list).
`parent_type`	string	yes	Type of parent: "space", "folder", "list", "everything", or "workspace".
`visibility`	string	no	Document visibility: "PUBLIC" or "PRIVATE". Default: PUBLIC.
`create_page`	boolean	no	Create an initial blank page. Default: true.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_list_doc_pages`

List all pages in a ClickUp document.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_list_doc_pages --json

Parameter	Type	Required	Description
`document_id`	string	yes	Document ID.
`max_depth`	integer	no	Max page depth (-1 for unlimited).
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_get_doc_pages`

Get the content of specific pages from a ClickUp document.

Operation: Read read
Schema command: kosmo integrations:schema clickup.clickup_get_doc_pages --json

Parameter	Type	Required	Description
`document_id`	string	yes	Document ID.
`page_ids`	string	yes	Comma-separated page IDs to retrieve.
`content_format`	string	no	Content format: "text/md" (default) or "text/html".
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_create_doc_page`

Create a new page in a ClickUp document.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_create_doc_page --json

Parameter	Type	Required	Description
`document_id`	string	yes	Document ID.
`name`	string	yes	Page name/title.
`content`	string	no	Page content.
`content_format`	string	no	Content format: "text/md" (default) or "text/html".
`sub_title`	string	no	Page subtitle.
`parent_page_id`	string	no	Parent page ID for creating sub-pages.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

`clickup.clickup_update_doc_page`

Update an existing page in a ClickUp document. Supports replace, append, or prepend content.

Operation: Write write
Schema command: kosmo integrations:schema clickup.clickup_update_doc_page --json

Parameter	Type	Required	Description
`document_id`	string	yes	Document ID.
`page_id`	string	yes	Page ID.
`name`	string	no	New page name/title.
`content`	string	no	New page content.
`content_format`	string	no	Content format: "text/md" (default) or "text/html".
`edit_mode`	string	no	Edit mode: "replace" (default), "append", or "prepend".
`sub_title`	string	no	New page subtitle.
`workspace_id`	string	no	Workspace ID. Uses configured default if omitted.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.