clickup-mcp

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":"[email protected]","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":"[email protected]", "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":"[email protected]", "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.