Skip to main content
Glama
deenesjakoruzh
cvrt-jh

clickup-mcp

by cvrt-jh
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

clickup-mcp

npm version License: MIT MCP SDK

轻量级 ClickUp MCP 服务器，专注于任务管理。39 个工具，针对 token 优化响应 - API 响应自动从数千字符缩减为精华内容。

为什么选择这个服务器？

ClickUp 的 API 返回极其冗长的 JSON。此服务器将其精简：

响应

之前

之后

缩减幅度

clickup_whoami

约 3,500 字符

约 160 字符

95%

clickup_create_comment

约 1,500 字符

约 38 字符

97%

更少的 token = 更快的响应、更低的成本、为 AI 留出更多上下文。

Related MCP server: ClickUp MCP Server

安装

npm install -g @cavort-it-systems/clickup-mcp

或直接运行：

npx @cavort-it-systems/clickup-mcp

配置

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / 手动配置

添加到你的 MCP 配置（~/.claude.json 或 Claude Desktop 设置）：

{
  "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 Token

  1. 前往 ClickUp 设置 > 应用

  2. 生成个人 API Token

  3. 将其设置为 CLICKUP_API_TOKEN

响应精简

所有响应都会自动裁剪以节省 token。ClickUp API 返回极其冗长的 JSON - 此服务器将其缩减为关键内容。

clickup_whoami - 从约 3,500 字符降至约 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 - 从约 1,500 字符降至 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{}

spaces

每个空间约 50 行布尔标志

sharing{}, permission_level

tasks

内部访问配置，无用

watchers[]

tasks

通常与指派人员相同

完整的用户对象

所有位置

缩减为 {id, username, email}

profilePicture, initials, color

users

视觉元数据，对 LLM 无用

version{} 数据块

comment/reply creates

内部版本数据

invited_by, profileInfo

members

邀请元数据

格式化打印 JSON

所有响应

紧凑的单行输出

空数组

tasks

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_add_task_to_list - 将任务添加到额外的列表（多归属）

  • clickup_remove_task_from_list - 从额外列表中移除任务

这些操作不会移动任务。 ClickUp v2 API 没有在列表间移动的端点。 已针对实时 API 于 2026-08-12 验证：POST /list/{list}/task/{task} 添加次要位置并使主列表保持不变，而 PUT /task/{id} 中的 list_id 返回 HTTP 200 并被静默忽略。要真正移动任务并保留其自定义 ID 和历史记录，请使用 ClickUp 网页界面（右键 -> 移动）。多列表成员资格还需要付费的“任务位于多个列表”功能。

工作区成员（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        # 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

许可证

MIT

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • microservices.sh

    MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cvrt-jh/clickup-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server