ClickUp MCP Server

基本能力

产品定位

ClickUp MCP Server 是一个用于与 ClickUp 工作空间集成的 Model Context Protocol 服务器实现，使 AI 助手能够与 ClickUp 进行交互。

核心功能

• 任务管理：创建和更新 ClickUp 任务
• 团队和列表管理：获取可访问的团队和文件夹中的列表
• 看板管理：在 ClickUp 空间中创建新看板

适用场景

• 自动化管理 ClickUp 任务
• 集成 AI 助手与 ClickUp 工作空间
• 批量处理 ClickUp 任务和列表

工具列表

• clickup_create_task: 在 ClickUp 列表中创建新任务
• clickup_update_task: 更新现有任务的属性
• clickup_get_teams: 检索所有可访问的团队
• clickup_get_lists: 获取特定文件夹中的所有列表
• clickup_create_board: 在 ClickUp 空间中创建新看板

常见问题解答

1. 认证错误
2. 验证环境变量中的 OAuth 凭据
3. 检查令牌是否过期

4. 确保重定向 URI 正确

5. 速率限制

6. 服务器实现了自动速率限制处理
7. 检查日志中的速率限制警告

8. 考虑实施请求批处理

9. 服务器无法启动

10. 检查环境变量是否正确设置
11. 验证端口 3000 是否可用
12. 检查 Claude for Desktop 日志

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

1. 通过 Claude for Desktop 配置：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

1. 重启 Claude for Desktop

或通过 Smithery 安装：

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

调试方式

1. 开发模式运行：

npm run dev

1. 查看日志：
2. Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
3. macOS: ~/Library/Logs/Claude/mcp*.log

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。