clickup-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLICKUP_API_TOKEN | Yes | Your ClickUp API token. Get it from ClickUp Settings > Apps. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| clickup_whoamiA | Get current user info and list of workspaces with members |
| clickup_get_spacesC | List all spaces in a workspace |
| clickup_get_foldersB | List folders in a space (includes nested lists) |
| clickup_get_listsA | Get lists in a folder, or folderless lists in a space. Provide either folder_id or space_id. |
| clickup_get_listB | Get a single list's details including its statuses |
| clickup_create_listA | Create a new list in a folder or as a folderless list in a space |
| clickup_delete_listA | Delete a list. This is permanent and cannot be undone. |
| clickup_get_taskC | Get a task by its ID |
| clickup_create_taskB | Create a new task in a list |
| clickup_update_taskC | Update a task. Assignees use add/rem arrays, not a flat list. |
| clickup_get_tasksB | List tasks in a list with optional filters |
| clickup_search_tasksC | Search tasks across an entire workspace |
| clickup_set_custom_fieldA | Set a custom field value on a task (update_task cannot do this) |
| clickup_delete_taskB | Permanently delete a task |
| clickup_add_task_to_listA | Add a task to an ADDITIONAL list (multi-homing). This does NOT move the task: its home list is unchanged and it may not appear in the target list's task query. Requires the paid Tasks-in-Multiple-Lists feature. There is no API to move a task between lists - use the ClickUp web UI (right-click -> Move) to preserve the custom ID and history. |
| clickup_remove_task_from_listA | Remove a task from an ADDITIONAL list it was multi-homed into. Cannot remove a task from its home list (use clickup_delete_task for that). Requires the paid Tasks-in-Multiple-Lists feature. |
| clickup_get_space_tagsA | List all tags in a space |
| clickup_create_space_tagB | Create a new tag in a space |
| clickup_edit_space_tagB | Edit (rename or recolor) a tag in a space |
| clickup_delete_space_tagB | Delete a tag from a space |
| clickup_add_tag_to_taskC | Add a tag to a task |
| clickup_remove_tag_from_taskC | Remove a tag from a task |
| clickup_create_checklistC | Create a checklist on a task |
| clickup_edit_checklistB | Rename or reorder a checklist |
| clickup_delete_checklistB | Delete a checklist and all its items |
| clickup_create_checklist_itemB | Add an item to a checklist |
| clickup_edit_checklist_itemC | Edit a checklist item (name, resolved status, assignee, or parent) |
| clickup_delete_checklist_itemC | Delete a checklist item |
| clickup_add_dependencyB | Add a dependency between tasks (waiting_on or blocking) |
| clickup_delete_dependencyB | Remove a dependency. Note: uses query params, not body. |
| clickup_add_task_linkC | Link two tasks together |
| clickup_delete_task_linkB | Remove a link between two tasks |
| clickup_create_commentC | Add a comment to a task |
| clickup_get_commentsA | Get comments on a task (paginated, 25 per page) |
| clickup_update_commentB | Edit a comment's text or resolve/unresolve it |
| clickup_create_replyB | Add a threaded reply to a comment |
| clickup_get_repliesA | Get threaded replies to a comment |
| clickup_get_workspace_membersA | Get all members across all workspaces (extracted from teams response) |
| clickup_get_list_membersB | Get members with access to a specific list |
| clickup_upload_attachmentB | Upload a local file (screenshot, PDF, ...) as an attachment to a task |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 40 tools
Most tools target a distinct resource+action, and descriptions actively disambiguate tricky pairs like clickup_add_task_to_list (multi-homing) vs. clicking delete, and clickup_update_task vs. clickup_set_custom_field. Minor potential confusion exists between clickup_get_task/clickup_get_tasks and clickup_get_tasks/clickup_search_tasks, but descriptions make the boundaries clear.
Nearly all tools follow a predictable clickup_verb_noun pattern (create_task, update_task, get_comments, delete_checklist_item). A few deviate slightly, e.g. plural list-verbs like clickup_get_spaces/get_folders/get_lists and the standalone clickup_whoami, but the convention is readable and consistent overall.
At 40 tools, the surface is heavy even for a rich domain like ClickUp, exceeding the 25+ threshold where each tool starts to struggle for its place. While the underlying product is genuinely large, the set is bloated enough to raise selection overhead.
Core lifecycle coverage is strong: full CRUD for tasks, lists, checklists, checklist items, space tags, dependencies, and links, plus comments and threaded replies. Notable gaps remain, such as no create/update/delete for spaces or folders (read-only) and no way to delete a comment.