ClickUp MCP（官方）

通过官方 MCP 服务器访问 ClickUp。支持完整的工作区搜索、任务管理、时间追踪、评论、聊天和文档。

设置

选项 1：直接 OAuth（仅限受支持的客户端）

ClickUp MCP 仅允许来自许可列表中的客户端的 OAuth：

• - Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、ChatGPT

bash

Claude Code

claude mcp add clickup --transport http https://mcp.clickup.com/mcp

然后在会话中运行 /mcp 进行授权

选项 2：Claude Code → mcporter（推荐）

使用 Claude Code 进行 OAuth，然后提取令牌用于 mcporter：

步骤 1：通过 Claude Code 授权
bash
claude mcp add clickup --transport http https://mcp.clickup.com/mcp
claude

在 Claude Code 中运行：/mcp

在浏览器中完成 OAuth

步骤 2：提取令牌
bash
jq -r .mcpOAuth | to_entries | .[] | select(.key | startswith(clickup)) | .value.accessToken ~/.claude/.credentials.json

步骤 3：添加到环境变量
bash

添加到 ~/.clawdbot/.env

CLICKUP_TOKEN=eyJhbGciOiJkaXIi...

步骤 4：配置 mcporter

添加到 config/mcporter.json：
json
{
mcpServers: {
clickup: {
baseUrl: https://mcp.clickup.com/mcp,
description: 官方 ClickUp MCP,
headers: {
Authorization: Bearer ${CLICKUP_TOKEN}
}
}
}
}

步骤 5：测试
bash
mcporter list clickup
mcporter call clickup.clickup_search(keywords: test, count: 3)

令牌刷新

令牌有效期较长（约 10 年）。如果过期：

1. 1. 在 Claude Code 中重新运行 /mcp
2. 从 ~/.claude/.credentials.json 重新提取令牌
3. 更新 .env 中的 CLICKUP_TOKEN

可用工具（32 个）

搜索

工具	描述
clickup_search	跨任务、文档、仪表板、聊天、文件的通用搜索

任务

工具	描述
clickupcreatetask	创建任务，包含名称、描述、状态、负责人、截止日期、优先级
clickupgettask

获取任务详情（可选包含子任务） | | clickupupdatetask | 更新任意任务字段 | | clickupattachtask_file | 附加文件到任务（URL 或 base64） | | clickupaddtagtotask | 为任务添加标签 | | clickupremovetagfromtask | 从任务移除标签 |

评论

工具	描述
clickupgettaskcomments	获取任务的所有评论
clickupcreatetaskcomment

添加评论（支持 @提及） |

时间追踪

工具	描述
clickupstarttimetracking	在任务上启动计时器
clickupstoptimetracking

停止活动计时器 | | clickupaddtime_entry | 手动记录时间 | | clickupgettasktimeentries | 获取任务的时间记录 | | clickupgetcurrenttimeentry | 检查活动计时器 |

工作区与层级结构

工具	描述
clickupgetworkspacehierarchy	获取完整结构（空间、文件夹、列表）
clickupcreate_list

在空间中创建列表 | | clickupcreatelistinfolder | 在文件夹中创建列表 | | clickupgetlist | 获取列表详情 | | clickupupdatelist | 更新列表设置 | | clickupcreatefolder | 在空间中创建文件夹 | | clickupgetfolder | 获取文件夹详情 | | clickupupdatefolder | 更新文件夹设置 |

成员

工具	描述
clickupgetworkspacemembers	列出所有工作区成员
clickupfindmemberby_name

按名称/邮箱查找成员 | | clickupresolveassignees | 从名称获取用户 ID |

聊天

工具	描述
clickupgetchatchannels	列出所有聊天频道
clickupsendchatmessage

向频道发送消息 |

文档

工具	描述
clickupcreatedocument	创建新文档
clickuplistdocument_pages

获取文档结构 | | clickupgetdocument_pages | 获取页面内容 | | clickupcreatedocument_page | 向文档添加页面 | | clickupupdatedocument_page | 编辑页面内容 |

使用示例

搜索工作区

bash
mcporter call clickup.clickup_search(
keywords: Q4 营销,
count: 10
)

创建任务

bash
mcporter call clickup.clickupcreatetask(
name: 审查 PR #42,
list_id: 901506994423,
description: 检查新功能,
status: 待办
)

更新任务

bash
mcporter call clickup.clickupupdatetask(
task_id: abc123,
status: 进行中
)

添加评论

bash
mcporter call clickup.clickupcreatetask_comment(
task_id: abc123,
comment_text: @Mark 你能审查一下这个吗？
)

时间追踪

bash

启动计时器

mcporter call clickup.clickupstarttime_tracking(
task_id: abc123,
description: 正在开发功能
)

停止计时器

mcporter call clickup.clickupstoptime_tracking()

手动记录时间（时长以毫秒为单位，例如 2 小时 = 7200000）

mcporter call clickup.clickupaddtime_entry( task_id: abc123, start: 2026-01-06 10:00, duration: 2h, description: 代码审查 )

获取工作区结构

bash
mcporter call clickup.clickupgetworkspace_hierarchy(limit: 10)

聊天

bash

列出频道

mcporter call clickup.clickupgetchat_channels()

发送消息

mcporter call clickup.clickupsendchat_message( channel_id: channel-123, content: 团队站会 5 分钟后开始！ )

限制

• - 无删除操作 — 安全措施；请使用 ClickUp UI
• 无自定义字段 — 官方 MCP 未暴露
• 无视图管理 — 不可用
• 需要 OAuth — 必须使用许可列表中的客户端（可通过 Claude Code 变通）
• 速率限制 — 与 ClickUp API 相同（约 100 次请求/分钟）

资源

• - ClickUp MCP 文档
• 支持的工具
• ClickUp API 参考
• 反馈 / 许可列表申请