AI导哈

任务管理服务器

ClickUp MCP Server是一个开源的任务管理服务器，通过AI代理（如Claude）直接管理ClickUp中的任务、列表和项目。

  • by HarunOr
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 HarunOr/mcp-clickup

使用说明

点击MCP服务器

开源 模型上下文协议 服务器用于 点击上.直接从Claude等AI代理管理任务、列表和项目。

该项目由克劳德代码（Claude-opus-4-6-20250616）生成。

特性

17工具 涵盖ClickUp的核心工作流程：

类别 工具
导航 get_user, list_workspaces, list_spaces, list_folders, list_lists, get_list
任务 get_task, list_tasks, search_tasks, create_task, update_task, delete_task
评论 get_task_comments, create_task_comment
检查表 create_checklist, create_checklist_item, update_checklist_item
  • 全任务CRUD，包括优先级、受让人、标签、截止日期和降价描述
  • 使用过滤器（状态、受让人、标签、日期范围）在工作区中搜索
  • 检查表管理（创建、添加项目、标记完成）
  • 任务注释（阅读和创建）
  • 列表上的自定义字段可见性

设置

1.获取您的ClickUp API令牌

首选 点击设置>应用程序>API代币 并生成个人令牌（以开头 pk_).

2.在shell环境中设置令牌

添加到您的shell配置文件中，以便跨会话使用：

鱼 (~/.config/fish/config.fish):

set -Ux CLICKUP_API_KEY pk_your_token_here

bash/zsh (~/.bashrc 或 ~/.zshrc):

export CLICKUP_API_KEY=pk_your_token_here

3.构建和注册

git clone https://github.com/scrapeer/clickup-mcp-server.git
cd clickup-mcp-server
make setup

这将安装依赖关系，构建服务器，并将其注册到Claude Code。令牌保留在shell环境中，而不是配置文件中。

make setup 默认为Claude Code。对于其他工具：

工具 注册 注销
克劳德代码 make register-claude make unregister-claude
OpenAI Codex命令行界面 make register-codex make unregister-codex
谷歌Gemini CLI make register-gemini make unregister-gemini

手动注册

如果您更喜欢手动注册或使用其他MCP客户端：

克劳德代码：

claude mcp add clickup -s user -t stdio \
  -e CLICKUP_API_KEY='${CLICKUP_API_KEY}' \
  -- node /path/to/clickup-mcp-server/dist/index.js

OpenAI Codex CLI：

codex mcp add clickup \
  --env CLICKUP_API_KEY='${CLICKUP_API_KEY}' \
  -- node /path/to/clickup-mcp-server/dist/index.js

谷歌Gemini命令行界面：

gemini mcp add -s user \
  -e CLICKUP_API_KEY='${CLICKUP_API_KEY}' \
  clickup node /path/to/clickup-mcp-server/dist/index.js

任何其他MCP客户端 （光标、VS代码、风帆等）——将其指向 node /path/to/clickup-mcp-server/dist/index.js 作为stdio服务器 CLICKUP_API_KEY 在环境中。

用法

配置后，Claude可以自然地管理您的ClickUp任务：

  • “显示我的ClickUp任务”--导航层次结构，列出任务
  • “在Sprint列表中创建一个名为‘修复登录错误’的任务”——使用上下文创建
  • “将任务8ckjp5标记为已完成”--更新状态
  • “我的高优先级任务的状态如何？”--使用筛选器进行搜索
  • “向任务8ckjp5添加评论”--发布评论

环境变量

变量 必填 描述
CLICKUP_API_KEY 是 个人API令牌(pk_...).在shell中设置，而不是在配置文件中设置。
CLICKUP_API_BASE_URL 没有 API基本URL（默认值： https://api.clickup.com/api/v2)

ClickUp层次结构

ClickUp数据模型是分层的：

Workspace > Space > Folder (optional) > List > Task

导航工具遵循此层次结构。从开始 clickup_list_workspaces 然后往下钻。

发展

make build          # Build TypeScript
make test           # Run test suite
make dev            # Watch mode (rebuild on change)

速率限制

ClickUp强制执行每个API令牌的费率限制：

计划 限额
免费/无限/商务 需要100次/分钟
商务升级 每分钟1000次
企业 10000需求/分钟

对于交互式人工智能的使用，免费层限制绰绰有余。

许可证

麻省理工学院

相关 MCP