mcpField
C
ClickUp MCP Server

ClickUp MCP Server

本地服务
github.com/nsxdavid生产力4380 周前更新
代码仓库

关于 ClickUp MCP Server

ClickUp MCP Server 通过标准化接口让 AI 助手访问和操作 ClickUp 工作区数据。它提供工作区、任务、文档等资源的查询，以及任务、文件夹和列表的创建与更新工具。

主要功能

  1. 01查询工作区与空间
  2. 02获取列表中的任务
  3. 03创建和更新任务
  4. 04查询工作区文档
  5. 05创建文件夹与列表

适用场景

  1. 01让 AI 助手查询 ClickUp 任务
  2. 02通过工具创建或更新任务
  3. 03在 ClickUp 中获取文档和组织列表

MCP 相关

这是一个 MCP 服务，向 MCP 客户端提供 ClickUp 数据查询和管理工具，包括工作区、任务、文档、文件夹和列表。

#clickup#mcp-server#api-integration

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "clickup-mcp-server-nsxdavid": {
      "command": "npx",
      "args": [
        "-y",
        "clickup-mcp-server"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "<CLICKUP_API_TOKEN>"
      }
    }
  }
}
启动命令npx -y clickup-mcp-server
需要配置的环境变量
CLICKUP_API_TOKEN密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmclickup-mcp-server

工具

42

收录的工具列表 · 更新于 3 周前

参数类型必填说明
workspace_idstring是要获取席位信息的工作区 ID

详细介绍

ClickUp MCP 服务

ClickUp MCP 服务徽标

npm 版本 许可证：MIT Node.js 版本 MCP SDK

一个模型上下文协议（MCP）服务，为 AI 助手提供与 ClickUp API 交互的标准化接口。此服务使 AI 系统能够访问和操作 ClickUp 数据，例如工作区、空间、文件夹、列表、任务、文档、评论和检查清单。

可用工具

  • get_workspaces：获取工作区列表
  • get_spaces：获取工作区内的空间
  • get_tasks：从列表中获取任务
  • create_task：创建新任务
  • update_task：更新现有任务
  • get_docs_from_workspace：获取工作区中的所有文档
  • create_folder：在空间中创建新文件夹
  • get_lists：获取文件夹或空间中的列表
  • create_list：创建新列表

安装

git clone https://github.com/nsxdavid/clickup-mcp-server.git
cd clickup-mcp-server
npm install

获取 ClickUp API 令牌

  1. 登录 ClickUp 账户
  2. 前往 Settings > Apps
  3. 点击 "Generate API Token"
  4. 复制令牌

配置

添加到 MCP 设置文件中：

{
  "mcpServers": {
    "clickup": {
      "command": "node",
      "args": ["/path/to/clickup-mcp-server/build/index.js"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  • 确保修正路径
  • 确保提供 API 令牌

备用安装方式（npx）

对于不想克隆代码仓库的用户，可以直接使用 npx 运行此软件包：

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": [
        "-y",
        "clickup-mcp-server"
      ],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  • 将 YOUR_API_TOKEN_HERE 替换为你的 API 令牌
  • 使用此方法无需安装或克隆

配置文件位置

  • Cline VSCode 扩展：~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Claude 桌面应用：
    • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows：%APPDATA%\Claude\claude_desktop_config.json

开发

构建
npm run build
运行测试
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。