ClickUp MCP（官方）

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

配置方法

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

ClickUp MCP 仅允许来自 白名单客户端 的 OAuth 授权：

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

# Claude Code
claude mcp add clickup --transport http https://mcp.clickup.com/mcp
# 然后在会话中运行 /mcp 完成授权

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

先使用 Claude Code 完成 OAuth 授权，再提取 Token 供 mcporter 使用：

步骤 1：通过 Claude Code 授权

claude mcp add clickup --transport http https://mcp.clickup.com/mcp
claude
# 在 Claude Code 中运行：/mcp
# 在浏览器中完成 OAuth 流程

步骤 2：提取 Token

jq -r '.mcpOAuth | to_entries | .[] | select(.key | startswith("clickup")) | .value.accessToken' ~/.claude/.credentials.json

步骤 3：添加到环境变量

# 添加至 ~/.clawdbot/.env
CLICKUP_TOKEN=eyJhbGciOiJkaXIi...

步骤 4：配置 mcporter

在 config/mcporter.json 中添加以下内容：

{
  "mcpServers": {
    "clickup": {
      "baseUrl": "https://mcp.clickup.com/mcp",
      "description": "Official ClickUp MCP",
      "headers": {
        "Authorization": "Bearer ${CLICKUP_TOKEN}"
      }
    }
  }
}

步骤 5：测试

mcporter list clickup
mcporter call 'clickup.clickup_search(keywords: "test", count: 3)'

Token 刷新

Token 有效期较长（约 10 年）。若已过期，请按以下步骤操作：

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

可用工具（32 个）

搜索

任务

评论

时间追踪

工作区与层级结构

成员

聊天

文档

使用示例

搜索工作区

mcporter call 'clickup.clickup_search(
  keywords: "Q4 marketing",
  count: 10
)'

创建任务

mcporter call 'clickup.clickup_create_task(
  name: "Review PR #42",
  list_id: "901506994423",
  description: "Check the new feature",
  status: "to do"
)'

更新任务

mcporter call 'clickup.clickup_update_task(
  task_id: "abc123",
  status: "in progress"
)'

添加评论

mcporter call 'clickup.clickup_create_task_comment(
  task_id: "abc123",
  comment_text: "@Mark can you review this?"
)'

时间追踪

# 启动计时器
mcporter call 'clickup.clickup_start_time_tracking(
  task_id: "abc123",
  description: "Working on feature"
)'

# 停止计时器
mcporter call 'clickup.clickup_stop_time_tracking()'

# 手动记录工时（时长单位为毫秒，例如 2 小时 = 7200000）
mcporter call 'clickup.clickup_add_time_entry(
  task_id: "abc123",
  start: "2026-01-06 10:00",
  duration: "2h",
  description: "Code review"
)'

获取工作区结构

mcporter call 'clickup.clickup_get_workspace_hierarchy(limit: 10)'

聊天

# 列出频道
mcporter call 'clickup.clickup_get_chat_channels()'

# 发送消息
mcporter call 'clickup.clickup_send_chat_message(
  channel_id: "channel-123",
  content: "Team standup in 5 minutes!"
)'

限制条件

• 不支持删除操作 —— 出于安全考虑，删除请使用 ClickUp UI
• 不支持自定义字段 —— 官方 MCP 未暴露该能力
• 不支持视图管理 —— 当前不可用
• 必须使用 OAuth —— 仅限白名单客户端；Claude Code 提供绕过方案
• 存在速率限制 —— 与 ClickUp API 一致（约 100 次请求/分钟）

相关资源

• ClickUp MCP 文档
• 支持的工具列表
• ClickUp API 参考文档
• 反馈 / 白名单申请