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.

ClickUp CLI Setup

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

Install, configure, and verify

# 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 reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

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

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

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

Discovery

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

Discovery commands

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

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`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.

Read read

Parameters: workspace_id, space_ids

Generic call

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

Shortcut

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

`clickup.clickup_search`

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

Read read

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

Generic 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

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`

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

Read read

Parameters: none

Generic call

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

Shortcut

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

`clickup.clickup_find_member`

Find a workspace member by name or email.

Read read

Parameters: query

Generic call

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

Shortcut

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

`clickup.clickup_resolve_members`

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

Read read

Parameters: query

Generic call

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

Shortcut

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

`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.

Read read

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

Generic 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

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`

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.

Read read

Parameters: task_id, include_subtasks

Generic call

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

Shortcut

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

`clickup.clickup_create_task`

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.

Write write

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

Generic 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

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`

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".

Write write

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

Generic 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

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`

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

Write write

Parameters: task_id

Generic call

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

Shortcut

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

`clickup.clickup_add_tag`

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

Write write

Parameters: task_id, tag_name

Generic call

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

Shortcut

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

`clickup.clickup_remove_tag`

Remove a tag from a ClickUp task.

Write write

Parameters: task_id, tag_name

Generic call

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

Shortcut

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

`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.

Write write

Parameters: task_id, file_path, filename, file_url

Generic 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

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`

Get all comments on a ClickUp task. Supports pagination.

Read read

Parameters: task_id, start, start_id

Generic call

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

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`

Add a new comment to a ClickUp task.

Write write

Parameters: task_id, comment_text, assignee, notify_all

Generic 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

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`

Get the currently running time tracking entry, if any.

Read read

Parameters: workspace_id

Generic call

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

Shortcut

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

`clickup.clickup_list_time_entries`

Get all time entries for a ClickUp task.

Read read

Parameters: task_id

Generic call

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

Shortcut

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

`clickup.clickup_start_timer`

Start a time tracking timer on a ClickUp task.

Write write

Parameters: task_id, description, billable, tags, workspace_id

Generic 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

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`

Stop the currently running time tracking timer.

Write write

Parameters: workspace_id

Generic call

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

Shortcut

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

`clickup.clickup_log_time`

Add a manual time entry to a ClickUp task.

Write write

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

Generic 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

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`

Get details of a ClickUp list by ID.

Read read

Parameters: list_id

Generic call

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

Shortcut

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

`clickup.clickup_create_list`

Create a new list in a ClickUp space.

Write write

Parameters: space_id, name, content, status

Generic call

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

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`

Create a new list in a ClickUp folder.

Write write

Parameters: folder_id, name, content, status

Generic 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

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`

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

Write write

Parameters: list_id, name, content, status

Generic call

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

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`

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

Read read

Parameters: folder_id

Generic call

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

Shortcut

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

`clickup.clickup_create_folder`

Create a new folder in a ClickUp space.

Write write

Parameters: space_id, name

Generic call

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

Shortcut

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

`clickup.clickup_update_folder`

Update a ClickUp folder's name.

Write write

Parameters: folder_id, name

Generic call

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

Shortcut

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

`clickup.clickup_list_channels`

List all chat channels in the ClickUp workspace.

Read read

Parameters: cursor, workspace_id

Generic call

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

Shortcut

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

`clickup.clickup_send_message`

Send a message to a ClickUp chat channel.

Write write

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

Generic 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

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`

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

Write write

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

Generic 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

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`

List all pages in a ClickUp document.

Read read

Parameters: document_id, max_depth, workspace_id

Generic call

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

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`

Get the content of specific pages from a ClickUp document.

Read read

Parameters: document_id, page_ids, content_format, workspace_id

Generic 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

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`

Create a new page in a ClickUp document.

Write write

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

Generic 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

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`

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

Write write

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

Generic 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

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 2 parameters

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 7 parameters

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 0 parameters

Schema command

kosmo integrations:schema clickup.clickup_list_members --json

Parameter	Type	Required	Description
No parameters.

clickup.clickup_find_member 1 parameters

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 1 parameters

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 7 parameters

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 2 parameters

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 10 parameters

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 10 parameters

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 1 parameters

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 2 parameters

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 2 parameters

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 4 parameters

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 3 parameters

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 4 parameters

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 1 parameters

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 1 parameters

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 5 parameters

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 1 parameters

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 7 parameters

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 1 parameters

Schema command

kosmo integrations:schema clickup.clickup_get_list --json

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

clickup.clickup_create_list 4 parameters

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 4 parameters

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 4 parameters

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 1 parameters

Schema command

kosmo integrations:schema clickup.clickup_get_folder --json

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

clickup.clickup_create_folder 2 parameters

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 2 parameters

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 2 parameters

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 6 parameters

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 6 parameters

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 3 parameters

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 4 parameters

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 7 parameters

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 8 parameters

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.