
Clickup Mcp
io.github.cvrt-jhPublished by GitHub account cvrt-jhv1.1.0Updated Oct 27, 2026
Lightweight ClickUp MCP server - 37 tools, token-optimized (95% smaller responses)
Overview
A local ClickUp MCP server with about 40 task-management tools whose responses are slimmed down to save tokens.
- What you can do
- Browse workspace structure: current user and workspaces, spaces, folders, lists, and create or delete lists
- Manage tasks: get, create, update, list, search and delete tasks, set custom field values, and add or remove tasks from additional lists
- Organize with tags and checklists: create, edit and delete space tags, tag or untag tasks, and manage checklists and their items
- Handle dependencies and links: add or remove task dependencies and task links
- Work with comments: create, read, update or resolve comments, and post or read threaded replies
- Upload local files as task attachments and look up workspace or list members
- When to use it
- Useful when you want an assistant to read and change ClickUp tasks, lists, tags, checklists and comments from a chat session, especially if token cost matters because ClickUp's raw API responses are very verbose.
- Requirements
- Runs locally over stdio via npx or a global npm install (Node.js). Needs a ClickUp Personal API Token in the CLICKUP_API_TOKEN environment variable. A token with access to several workspaces also needs CLICKUP_TEAM_ID set. Network access to the ClickUp API.
Installation
In SourceWeft
- Open Clickup Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
clickup-mcp
Unmaintained. ClickUp is retired at CAVORT (2026-10-18, cutover to Console complete). This server is kept as is and no longer developed.
[npm version] [License: MIT] [MCP SDK]
Lightweight ClickUp MCP server focused on task management. 40 tools with token-optimized responses - API responses automatically slimmed from thousands of characters to essentials.
Why This Server?
ClickUp's API returns extremely verbose JSON. This server strips it down:
Less tokens = faster responses, lower costs, more context for your AI.
Installation
Or run directly:
Configuration
Claude Code CLI
Claude Desktop / Manual
Add to your MCP config (~/.claude.json or Claude Desktop settings):
From Source
Then configure with the built path:
Custom task IDs
Every tool that takes a task_id accepts the custom ID as well (DEV-1217), not only
the internal one (86caqr85m). The server adds custom_task_ids=true&team_id=... itself.
The workspace id comes from CLICKUP_TEAM_ID, or, if unset, from the token's only
workspace (looked up once). A token with access to several workspaces must set
CLICKUP_TEAM_ID.
Get Your API Token
- Go to ClickUp Settings > Apps
- Generate a Personal API Token
- Set as
CLICKUP_API_TOKEN
Response Slimming
All responses are automatically trimmed to save tokens. The ClickUp API returns extremely verbose JSON - this server strips it down to what matters.
clickup_whoami - from ~3,500 chars to ~160:
clickup_create_comment - from ~1,500 chars to 38:
What gets stripped:
Tools (40)
Navigation (7)
clickup_whoami- Current user + workspacesclickup_get_spaces- Spaces in workspaceclickup_get_folders- Folders in spaceclickup_get_lists- Lists in folder or spaceclickup_get_list- Single list detailsclickup_create_list- Create list in folder or spaceclickup_delete_list- Delete a list (permanent)
Task CRUD (5)
clickup_get_task- Get task by IDclickup_create_task- Create task with all fieldsclickup_update_task- Update any task fieldclickup_get_tasks- List tasks in a listclickup_search_tasks- Search tasks across workspace
Custom Fields (1)
clickup_set_custom_field- Set custom field value
Tags (6)
clickup_get_space_tags- List space tagsclickup_create_space_tag- Create tagclickup_edit_space_tag- Edit tagclickup_delete_space_tag- Delete tagclickup_add_tag_to_task- Tag a taskclickup_remove_tag_from_task- Untag a task
Checklists (6)
clickup_create_checklist- Create checklistclickup_edit_checklist- Edit checklistclickup_delete_checklist- Delete checklistclickup_create_checklist_item- Add itemclickup_edit_checklist_item- Edit itemclickup_delete_checklist_item- Delete item
Dependencies (4)
clickup_add_dependency- Add dependencyclickup_delete_dependency- Remove dependencyclickup_add_task_link- Link tasksclickup_delete_task_link- Unlink tasks
Comments (5)
clickup_create_comment- Add commentclickup_get_comments- Get commentsclickup_update_comment- Edit/resolve commentclickup_create_reply- Threaded replyclickup_get_replies- Get replies
Delete Task (1)
clickup_delete_task- Delete a task
Multi-List Membership (2)
clickup_add_task_to_list- Add a task to an additional list (multi-homing)clickup_remove_task_from_list- Remove a task from an additional list
These do not move a task. The ClickUp v2 API has no move-between-lists endpoint. Verified against the live API 2026-08-12:
POST /list/{list}/task/{task}adds a secondary location and leaves the home list unchanged, while alist_idinPUT /task/{id}returns HTTP 200 and is silently ignored. To genuinely move a task and keep its custom ID and history, use the ClickUp web UI (right-click -> Move). Multi-list membership also requires the paid Tasks-in-Multiple-Lists feature.
Attachments (1)
clickup_upload_attachment- Upload a local file (screenshot, PDF) to a task
Workspace Members (2)
clickup_get_workspace_members- All workspace membersclickup_get_list_members- List-specific members
Architecture
License
MIT
Source: README.md at commit fdb52d1
Tools
0Version history
2- v1.1.0LatestOct 8, 2026
- v1.0.3Sep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts