local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with ClickUp workspaces, providing tools for task management (creating and updating tasks), team and list management (retrieving teams and lists), and board management (creating boards).

ClickUp MCP 服务器

用于 ClickUp 集成的模型上下文协议服务器实现，使 AI 助手能够与 ClickUp 工作区进行交互。

快速入门

配置 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"
      }
    }
  }
}

重启 Claude 桌面版

就是这样！服务器将在需要时自动下载并启动。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 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 是否可用
- 检查 Claude 的桌面日志

获取日志

您可以在以下位置找到 Claude for Desktop 日志：

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

执照

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

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

Related Resources

Reddit Discussion about this server

ClickUp MCP Server