点击mcp
](https://www.npmjs.com/package/@cavort-it-systems/clickup-mcp)  
轻量级ClickUp MCP服务器,专注于任务管理。37工具 令牌优化响应 -API响应自动从数千个字符精简为基本字符。
为什么选择此服务器?
ClickUp的API返回极其冗长的JSON。此服务器将其剥离:
| 响应 | 之前 | 之后 | 减少 |
|---|---|---|---|
clickup_whoami | 约3500个字符 | 约160个字符 | 95% |
clickup_create_comment | ~1500个字符 | ~38个字符 | 97% |
更少的令牌=更快的响应、更低的成本、更多的AI上下文。
安装
npm install -g @cavort-it-systems/clickup-mcp或者直接运行:
npx @cavort-it-systems/clickup-mcp配置
Claude 代码命令行界面
claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp克劳德桌面/手册
添加到MCP配置(~/.claude.json 或克劳德桌面设置):
{
"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获取您的API代币
- 前往ClickUp设置>应用
- 生成个人API令牌
- 设为
CLICKUP_API_TOKEN
响应瘦身
所有响应都会自动修剪以保存令牌。ClickUp API返回极其冗长的JSON——该服务器将其分解为重要内容。
clickup_whoami --从约3500个字符到约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 --从~1500个字符到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}什么被剥夺了:
| 字段 | 位置 | 为什么 |
|---|---|---|
features{} | 空格 | 每个空格约50行布尔标志 |
sharing{}, permission_level | tasks | 内部访问配置,无用 |
watchers[] | 任务 | 通常与指定人员相同 |
| 全用户对象 | 无处不在 | 简化为 {id, username, email} |
profilePicture, initials, color | 用户 | 可视化元数据,对LLM没有用 |
version{} blobs | 创建注释/回复 | 内部版本数据 |
invited_by, profileInfo | 成员 | 邀请元数据 |
| 漂亮的JSON打印 | 所有响应 | 简洁的单行输出 |
| 空数组 | 任务 | checklists, dependencies, custom_fields 空时省略 |
工具(37)
导航(7)
clickup_whoami-当前用户+工作区clickup_get_spaces-工作空间中的空间clickup_get_folders-空间中的文件夹clickup_get_lists-在文件夹或空间中列出clickup_get_list-单个列表详细信息clickup_create_list-在文件夹或空间中创建列表clickup_delete_list-删除列表(永久)
任务CRUD(5)
clickup_get_task-按ID获取任务clickup_create_task-创建包含所有字段的任务clickup_update_task-更新任何任务字段clickup_get_tasks-在列表中列出任务clickup_search_tasks-跨工作区搜索任务
自定义字段(1)
clickup_set_custom_field-设置自定义字段值
标签(6)
clickup_get_space_tags-列出空间标签clickup_create_space_tag-创建标签clickup_edit_space_tag-编辑标签clickup_delete_space_tag-删除标签clickup_add_tag_to_task-标记任务clickup_remove_tag_from_task-取消标记任务
检查表(6)
clickup_create_checklist-创建检查表clickup_edit_checklist-编辑检查表clickup_delete_checklist-删除检查表clickup_create_checklist_item-添加项目clickup_edit_checklist_item-编辑项目clickup_delete_checklist_item-删除项目
依赖关系(4)
clickup_add_dependency-添加依赖关系clickup_delete_dependency-删除依赖关系clickup_add_task_link-链接任务clickup_delete_task_link-取消链接任务
评论(5)
clickup_create_comment-添加评论clickup_get_comments-获取评论clickup_update_comment-编辑/解析评论clickup_create_reply-线程回复clickup_get_replies-获取回复
删除任务(1)
clickup_delete_task-删除任务
工作区成员(2)
clickup_get_workspace_members-所有工作区成员clickup_get_list_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 # 7 tools (CRUD + custom fields + delete)
tags.ts # 6 tools
checklists.ts # 6 tools
dependencies.ts # 4 tools
comments.ts # 5 tools
members.ts # 2 tools许可证
麻省理工学院

