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 MCP Integration for Codex

Connect ClickUp to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

34 functions 15 read 19 write API token auth

Submit ClickUp feedback View package source

Connect ClickUp to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

ClickUp MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-clickup": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=clickup",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=clickup --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only ClickUp instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

ClickUp Tools Visible to Codex

Codex sees stable MCP tool names generated from the ClickUp integration catalog.

MCP tool	Source function	Type	Description
`integration__clickup__clickup_get_hierarchy`	`clickup.clickup_get_hierarchy`	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.
`integration__clickup__clickup_search`	`clickup.clickup_search`	Read	Search tasks across the ClickUp workspace. Supports filtering by query, statuses, assignees, and more. Returns matching tasks with their details.
`integration__clickup__clickup_list_members`	`clickup.clickup_list_members`	Read	Get all workspace members with their IDs, names, emails, and roles.
`integration__clickup__clickup_find_member`	`clickup.clickup_find_member`	Read	Find a workspace member by name or email.
`integration__clickup__clickup_resolve_members`	`clickup.clickup_resolve_members`	Read	Convert member names or emails to ClickUp user IDs for assigning tasks.
`integration__clickup__clickup_get_tasks`	`clickup.clickup_get_tasks`	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.
`integration__clickup__clickup_get_task`	`clickup.clickup_get_task`	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.
`integration__clickup__clickup_create_task`	`clickup.clickup_create_task`	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.
`integration__clickup__clickup_update_task`	`clickup.clickup_update_task`	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".
`integration__clickup__clickup_delete_task`	`clickup.clickup_delete_task`	Write	Delete a ClickUp task permanently. Supports custom task IDs like "DEV-42". This action cannot be undone.
`integration__clickup__clickup_add_tag`	`clickup.clickup_add_tag`	Write	Add an existing tag to a ClickUp task. The tag must already exist in the space.
`integration__clickup__clickup_remove_tag`	`clickup.clickup_remove_tag`	Write	Remove a tag from a ClickUp task.
`integration__clickup__clickup_attach_file`	`clickup.clickup_attach_file`	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.
`integration__clickup__clickup_read_comments`	`clickup.clickup_read_comments`	Read	Get all comments on a ClickUp task. Supports pagination.
`integration__clickup__clickup_add_comment`	`clickup.clickup_add_comment`	Write	Add a new comment to a ClickUp task.
`integration__clickup__clickup_current_time_entry`	`clickup.clickup_current_time_entry`	Read	Get the currently running time tracking entry, if any.
`integration__clickup__clickup_list_time_entries`	`clickup.clickup_list_time_entries`	Read	Get all time entries for a ClickUp task.
`integration__clickup__clickup_start_timer`	`clickup.clickup_start_timer`	Write	Start a time tracking timer on a ClickUp task.
`integration__clickup__clickup_stop_timer`	`clickup.clickup_stop_timer`	Write	Stop the currently running time tracking timer.
`integration__clickup__clickup_log_time`	`clickup.clickup_log_time`	Write	Add a manual time entry to a ClickUp task.
`integration__clickup__clickup_get_list`	`clickup.clickup_get_list`	Read	Get details of a ClickUp list by ID.
`integration__clickup__clickup_create_list`	`clickup.clickup_create_list`	Write	Create a new list in a ClickUp space.
`integration__clickup__clickup_create_list_in_folder`	`clickup.clickup_create_list_in_folder`	Write	Create a new list in a ClickUp folder.
`integration__clickup__clickup_update_list`	`clickup.clickup_update_list`	Write	Update a ClickUp list's name, content, or status.
`integration__clickup__clickup_get_folder`	`clickup.clickup_get_folder`	Read	Get details of a ClickUp folder by ID, including its lists.
`integration__clickup__clickup_create_folder`	`clickup.clickup_create_folder`	Write	Create a new folder in a ClickUp space.
`integration__clickup__clickup_update_folder`	`clickup.clickup_update_folder`	Write	Update a ClickUp folder's name.
`integration__clickup__clickup_list_channels`	`clickup.clickup_list_channels`	Read	List all chat channels in the ClickUp workspace.
`integration__clickup__clickup_send_message`	`clickup.clickup_send_message`	Write	Send a message to a ClickUp chat channel.
`integration__clickup__clickup_manage_document`	`clickup.clickup_manage_document`	Write	Create a ClickUp document in a space, folder, or list. Specify the parent container and visibility (PUBLIC or PRIVATE).

Showing 30 of 34 functions. See the ClickUp MCP reference for the full list.

Related ClickUp Pages

ClickUp CLIUse direct JSON commands instead of MCP discovery. ClickUp MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.