KosmoKrator

productivity

ClickUp MCP, CLI, and Lua Integration for AI Agents

ClickUp integration docs for AI agents: MCP gateway setup, ClickUp CLI commands, Lua API reference, credentials, and function schemas.

34 functions 15 read 19 write API token auth
Submit ClickUp feedback View package source

ClickUp for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata
integration_slug
clickup
route_slug
clickup
package
clickup
auth_strategy
api_token API token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true
supports_multi_account
true

Quick Links

Lua APIAgent-facing namespace and function reference. ClickUp CLIHeadless setup and direct function calls. ClickUp MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

ClickUp MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for ClickUp.

Claude Code ClickUp MCP setup for Claude Code. Cursor ClickUp MCP setup for Cursor. Codex ClickUp MCP setup for Codex. OpenAI Agents ClickUp MCP setup for OpenAI Agents SDK. Claude Agent SDK ClickUp MCP setup for Claude Agent SDK. Vercel AI SDK ClickUp MCP setup for Vercel AI SDK. LangChain ClickUp MCP setup for LangChain. LangGraph ClickUp MCP setup for LangGraph. CrewAI ClickUp MCP setup for CrewAI. MCP clients ClickUp MCP setup for Generic MCP Clients.

ClickUp CLI Matrix

Use these pages for direct ClickUp CLI workflows in scripts, CI, cron, and agent wrappers.

CI ClickUp CLI for CI. Cron Jobs ClickUp CLI for cron jobs. Shell Scripts ClickUp CLI for shell scripts. Headless Automation ClickUp CLI for headless automation. Coding Agents ClickUp CLI for coding agents.

Function Catalog

FunctionTypeParametersDescription
clickup.clickup_get_hierarchy Read read 2 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.
clickup.clickup_search Read read 7 Search tasks across the ClickUp workspace. Supports filtering by query, statuses, assignees, and more. Returns matching tasks with their details.
clickup.clickup_list_members Read read 0 Get all workspace members with their IDs, names, emails, and roles.
clickup.clickup_find_member Read read 1 Find a workspace member by name or email.
clickup.clickup_resolve_members Read read 1 Convert member names or emails to ClickUp user IDs for assigning tasks.
clickup.clickup_get_tasks Read read 7 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.
clickup.clickup_get_task Read read 2 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.
clickup.clickup_create_task Write write 10 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.
clickup.clickup_update_task Write write 10 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".
clickup.clickup_delete_task Write write 1 Delete a ClickUp task permanently. Supports custom task IDs like "DEV-42". This action cannot be undone.
clickup.clickup_add_tag Write write 2 Add an existing tag to a ClickUp task. The tag must already exist in the space.
clickup.clickup_remove_tag Write write 2 Remove a tag from a ClickUp task.
clickup.clickup_attach_file Write write 4 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.
clickup.clickup_read_comments Read read 3 Get all comments on a ClickUp task. Supports pagination.
clickup.clickup_add_comment Write write 4 Add a new comment to a ClickUp task.
clickup.clickup_current_time_entry Read read 1 Get the currently running time tracking entry, if any.
clickup.clickup_list_time_entries Read read 1 Get all time entries for a ClickUp task.
clickup.clickup_start_timer Write write 5 Start a time tracking timer on a ClickUp task.
clickup.clickup_stop_timer Write write 1 Stop the currently running time tracking timer.
clickup.clickup_log_time Write write 7 Add a manual time entry to a ClickUp task.
clickup.clickup_get_list Read read 1 Get details of a ClickUp list by ID.
clickup.clickup_create_list Write write 4 Create a new list in a ClickUp space.
clickup.clickup_create_list_in_folder Write write 4 Create a new list in a ClickUp folder.
clickup.clickup_update_list Write write 4 Update a ClickUp list's name, content, or status.
clickup.clickup_get_folder Read read 1 Get details of a ClickUp folder by ID, including its lists.
clickup.clickup_create_folder Write write 2 Create a new folder in a ClickUp space.
clickup.clickup_update_folder Write write 2 Update a ClickUp folder's name.
clickup.clickup_list_channels Read read 2 List all chat channels in the ClickUp workspace.
clickup.clickup_send_message Write write 6 Send a message to a ClickUp chat channel.
clickup.clickup_manage_document Write write 6 Create a ClickUp document in a space, folder, or list. Specify the parent container and visibility (PUBLIC or PRIVATE).
clickup.clickup_list_doc_pages Read read 3 List all pages in a ClickUp document.
clickup.clickup_get_doc_pages Read read 4 Get the content of specific pages from a ClickUp document.
clickup.clickup_create_doc_page Write write 7 Create a new page in a ClickUp document.
clickup.clickup_update_doc_page Write write 8 Update an existing page in a ClickUp document. Supports replace, append, or prepend content.