clickup-mcp
About
Lightweight ClickUp MCP server with 35 tools. Token-optimized responses reduce API verbosity by 95%+ (3500 chars → 160). Tasks, comments, checklists, tags, dependencies.
Details
- Author
- cvrt-jh
- Categories
- Productivity, Project Management, Automation
Jump to
Setup
Install clickup-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/cvrt-jh/clickup-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Lightweight ClickUp MCP server focused on task management. 39 tools withtoken-optimized responses- API responses automatically slimmed from thousands of characters to essentials.
ClickUp's API returns extremely verbose JSON. This server strips it down:
Less tokens = faster responses, lower costs, more context for your AI.
npm install -g @cavort-it-systems/clickup-mcp
claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp
Add to your MCP config (~/.claude.jsonor Claude Desktop settings):
{ "mcpServers": { "clickup": { "command": "npx", "args": ["@cavort-it-systems/clickup-mcp"], "env": { "CLICKUP_API_TOKEN": "your-token" } } } }
git clone https://github.com/cvrt-jh/clickup-mcp.git cd clickup-mcp npm install && npm run build
claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js
- Go to ClickUp Settings > Apps
- Generate a Personal API Token
- Set asCLICKUP_API_TOKEN
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:
// Before (ClickUp API raw) {"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1", "profilePicture":"https://attachments.clickup.com/...","initials":"JD", "week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"}, "teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86", "avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...", "members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com", "color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2, "role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...", "date_invited":"..."},"invited_by":{"id":22222222,...}, "can_see_time_spent":true,...}, ...]}]}} // After (slimmed) {"id":12345678,"username":"Jane Doe","email":"jane@example.com", "timezone":"Europe/Berlin","workspaces":[{"id":"99999999", "name":"My Workspace","member_count":4}]}
clickup_create_comment- from ~1,500 chars to 38:
// Before {"id":90150191300876,"hist_id":"...","date":1770053982842, "version":{"object_type":"comment","object_id":"...","workspace_id":99999999, "operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false, "audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}} // After {"id":90150191300876,"date":1770053982842}
- clickup_whoami- Current user + workspaces
- clickup_get_spaces- Spaces in workspace
- clickup_get_folders- Folders in space
- clickup_get_lists- Lists in folder or space
- clickup_get_list- Single list details
- clickup_create_list- Create list in folder or space
- clickup_delete_list- Delete a list (permanent)
- clickup_get_task- Get task by ID
- clickup_create_task- Create task with all fields
- clickup_update_task- Update any task field
- clickup_get_tasks- List tasks in a list
- clickup_search_tasks- Search tasks across workspace
- clickup_set_custom_field- Set custom field value
- clickup_get_space_tags- List space tags
- clickup_create_space_tag- Create tag
- clickup_edit_space_tag- Edit tag
- clickup_delete_space_tag- Delete tag
- clickup_add_tag_to_task- Tag a task
- clickup_remove_tag_from_task- Untag a task
- clickup_create_checklist- Create checklist
- clickup_edit_checklist- Edit checklist
- clickup_delete_checklist- Delete checklist
- clickup_create_checklist_item- Add item
- clickup_edit_checklist_item- Edit item
- clickup_delete_checklist_item- Delete item
- clickup_add_dependency- Add dependency
- clickup_delete_dependency- Remove dependency
- clickup_add_task_link- Link tasks
- clickup_delete_task_link- Unlink tasks
- clickup_create_comment- Add comment
- clickup_get_comments- Get comments
- clickup_update_comment- Edit/resolve comment
- clickup_create_reply- Threaded reply
- clickup_get_replies- Get replies
- clickup_add_task_to_list- Add a task to anadditionallist (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.
- clickup_get_workspace_members- All workspace members
- clickup_get_list_members- List-specific members
src/ index.ts # Entry: McpServer + StdioServerTransport client.ts # ClickUp API v2 fetch wrapper types.ts # Shared Zod schemas + jsonResult helper slim.ts # Response slimming transformers tools/ navigation.ts # 7 tools tasks.ts # 9 tools (CRUD + custom fields + delete + multi-list) tags.ts # 6 tools checklists.ts # 6 tools dependencies.ts # 4 tools comments.ts # 5 tools members.ts # 2 tools
Perform queries and entity operations in your Fibery workspace.
Keep teams & agents coordinated automatically
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.
advanced-math-mcp — MCP server for linear algebra, calculus, and symbolic math. 17 tools with a unified evaluate() expression engine. Supports matrices, eigenvalues, SVD, integrals, limits, derivatives, and more.
An MCP interface for Atlassian products, including Jira and Bitbucket.
The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.
About A repo-native task graph as plain Markdown files, served to AI agents over MCP and to humans over a clean web UI .
Integrate ClickUp with AI applications to manage tasks, spaces, lists, and folders.
Interact with the ClickUp API to manage tasks, lists, and spaces, automating project planning and workflows.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


