ClickUp MCP (官方)

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

设置

选项一：直接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
# Then /mcp in session to authorize

选项二：Claude Code → mcporter (推荐)

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

步骤1：通过Claude Code授权

claude mcp add clickup --transport http https://mcp.clickup.com/mcp
claude
# In Claude Code, run: /mcp
# Complete OAuth in browser

步骤2：提取令牌

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

步骤3：添加到环境变量

# Add to ~/.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)'

令牌刷新

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

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

.env

可用工具 (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?"
)'

时间追踪

# Start timer
mcporter call 'clickup.clickup_start_time_tracking(
  task_id: "abc123",
  description: "Working on feature"
)'

# Stop timer
mcporter call 'clickup.clickup_stop_time_tracking()'

# Log time manually (duration in ms, e.g., 2h = 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)'

聊天

# List channels
mcporter call 'clickup.clickup_get_chat_channels()'

# Send message
mcporter call 'clickup.clickup_send_chat_message(
  channel_id: "channel-123",
  content: "Team standup in 5 minutes!"
)'

限制

• 无删除操作—— 安全措施；请使用ClickUp界面
• 无自定义字段—— 官方MCP未提供此功能
• 无视图管理—— 不可用
• 需要OAuth认证—— 必须使用白名单客户端（Claude Code有变通方案）
• 速率限制—— 与ClickUp API相同（约100次请求/分钟）

资源

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