ClickUp AI助手

@Nazruden/clickup-mcp-server

0 Stars 391 次浏览 Nazruden 更新于 2026-08-23

该服务器将AI助手与ClickUp工作区集成，通过安全的OAuth2身份验证过程实现任务、团队、列表和看板管理。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：CLICKUP_CLIENT_ID、CLICKUP_CLIENT_SECRET、CLICKUP_REDIRECT_URI、LOG_LEVEL、PORT

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

clickup_create_task 9 个参数需填 2 项 Create a new task in ClickUp workspace

Create a new task in ClickUp workspace

必填参数：list_id、name

clickup_update_task 9 个参数需填 1 项 Update an existing task in ClickUp

Update an existing task in ClickUp

必填参数：task_id

clickup_get_teams Get all teams accessible to the authenticated user

Get all teams accessible to the authenticated user

该工具无需必填参数，直接调用即可

clickup_get_lists 1 个参数需填 1 项 Get all lists in a specific folder

Get all lists in a specific folder

必填参数：folder_id

clickup_create_board 3 个参数需填 2 项 Create a new board in a ClickUp space

Create a new board in a ClickUp space

必填参数：space_id、name

服务介绍

ClickUp MCP 服务器

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

快速开始

配置 Desktop 版 Claude：

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

重启 Desktop 版 Claude

就这样！当需要时，服务器将被自动下载并启动。

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Desktop 版 Claude 的 ClickUp MCP 服务器：

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

环境变量

必需的环境变量：

CLICKUP_CLIENT_ID: 您的 ClickUp OAuth 客户端 ID
CLICKUP_CLIENT_SECRET: 您的 ClickUp OAuth 客户端密钥
CLICKUP_REDIRECT_URI: OAuth 重定向 URI（默认：http://localhost:3000/oauth/callback）

可选的环境变量：

PORT: 服务器端口（默认：3000）
LOG_LEVEL: 日志级别（默认：info）

可用工具

任务管理

clickup_create_task: 在 ClickUp 列表中创建新任务
clickup_update_task: 更新现有任务的属性

团队和列表管理

clickup_get_teams: 检索所有可访问的团队
clickup_get_lists: 获取特定文件夹中的所有列表

看板管理

clickup_create_board: 在 ClickUp 空间中创建新看板

开发

克隆仓库
安装依赖项：

npm install

以开发模式启动：

npm run dev

构建生产版本：

npm run build

运行测试：

npm test

安全性

所有令牌在静止状态下加密
使用 OAuth2 流程进行安全认证
不记录敏感数据
实施速率限制以防止 API 滥用

故障排除

常见问题

认证错误
- 核实环境变量中的 OAuth 凭证
- 检查令牌是否过期
- 确保正确的重定向 URI
速率限制
- 服务器实现了自动处理速率限制
- 检查日志中的速率限制警告
- 考虑实施请求批处理
服务器无法启动
- 检查环境变量是否正确设置
- 确认端口 3000 可用
- 查看 Desktop 版 Claude 的日志

获取日志

Desktop 版 Claude 的日志可以在以下位置找到：

Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log
macOS: ~/Library/Logs/Claude/mcp*.log

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件

查看源码项目主页