Clickup Full API MCP

点击MCP服务器

用于ClickUp API v2的全面模型上下文协议（MCP）服务器，提供所有可用端点的全面覆盖。

特性

• API全面覆盖：120多个工具，涵盖所有ClickUp API v2端点
• 类型安全：完整的类型提示和Pydantic验证
• 异步：基于async/await构建，实现高效运行
• 没有硬编码的秘密：通过环境变量的API令牌

安装

# Using pip
pip install clickup-mcp

# From source
git clone https://github.com/Yes-Gaming/clickup-mcp.git
cd clickup-mcp
pip install -e .

配置

将您的ClickUp API令牌设置为环境变量：

export CLICKUP_API_TOKEN="pk_your_token_here"

您可以从ClickUp设置>应用程序>API令牌获取您的个人API令牌。

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "clickup": {
      "command": "clickup-mcp",
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_token_here"
      }
    }
  }
}

或者使用uvx：

{
  "mcpServers": {
    "clickup": {
      "command": "uvx",
      "args": ["clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "pk_your_token_here"
      }
    }
  }
}

可用工具（120+）

授权（1）

工作区（3）

空间（5）

文件夹（5）

列表（10）

任务（11）

任务清单（6）

任务关系（4）

评论（10）

附件（1）

自定义字段（7）

标签（6）

目标和关键成果（8）

时间追踪（14）

成员（2）

用户（4）

客人（10）

用户组（4）

角色（1）

浏览次数（12）

Webhooks（4）

模板（1）

共享层次结构（1）

使用示例

获取所有工作区

# The tool will return all workspaces you have access to
result = await get_workspaces()

任务

result = await create_task(
    list_id="12345",
    name="My new task",
    description="Task description",
    priority=2,  # High priority
    assignees=[12345678],
    due_date=1735689600000  # Unix timestamp in ms
)

开始时间跟踪

result = await start_time_entry(
    team_id="123456",
    task_id="abc123",
    description="Working on feature",
    billable=True
)

创建一个网络钩子

result = await create_webhook(
    team_id="123456",
    endpoint="https://your-server.com/webhook",
    events=["taskCreated", "taskUpdated"],
    space_id="789"  # Optional: limit to specific space
)

Webhook事件

可用的webhook事件：

• 任务： taskCreated, taskUpdated, taskDeleted, taskPriorityUpdated, taskStatusUpdated, taskAssigneeUpdated, taskDueDateUpdated, taskTagUpdated, taskMoved, taskCommentPosted, taskCommentUpdated, taskTimeEstimateUpdated, taskTimeTrackedUpdated
• 列表： listCreated, listUpdated, listDeleted
• 文件夹： folderCreated, folderUpdated, folderDeleted
• 空间： spaceCreated, spaceUpdated, spaceDeleted
• 目标： goalCreated, goalUpdated, goalDeleted
• 关键结果： keyResultCreated, keyResultUpdated, keyResultDeleted

使用 * 订阅所有活动。

API 参考

此MCP服务器实现 点击API第2版.有关详细的参数文档，请参阅API官方文档。

发展

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check .

许可证

MIT许可证-请参阅许可证文件。

贡献

欢迎投稿！请在GitHub上打开问题或PR。