ClickUp管理控制平台

ClickUp MCP是一个FastMCP服务器,通过验证的工具表面暴露ClickUp工作区操作,为代理和本地工具提供结构化的方式来读取和更新ClickUp数据。

  • by polaralias
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Polaralias/clickup-mcp

使用说明


type: "Repository Guide" title: "ClickUp MCP" description: "Documents ClickUp MCP for the clickup-mcp repository." timestamp: 2026-07-28T21:55:36Z authority: canonical verification: untested owner: polaralias tags:

  • clickup-mcp
  • repository-guide navigation: role: entry-point order: 10

ClickUp MCP

ClickUp MCP is a FastMCP server that exposes ClickUp workspace operations through a validated, checked-in tool surface.

What It Does

The server gives agents and local tools a structured way to read and update ClickUp data without inventing ad hoc wrappers on each project. The repository focuses on a fully declared tool surface, evidence-backed validation, and predictable local runtime behaviour.

Core Capabilities

  • workspace, space, folder, and list operations
  • task creation, updates, and lifecycle actions
  • member, doc, view, time-tracking, and custom-field coverage
  • checked-in tool manifest and validation status artefacts
  • local and live smoke validation paths

Quick Start

Run locally:

python scripts/run_server.py serve

Useful helpers:

python scripts/run_server.py doctor
python scripts/run_server.py url

Configuration

Common live runtime configuration:

  • CLICKUP_API_TOKEN
  • CLICKUP_TEAM_ID
  • CLICKUP_MCP_API_KEY or MCP_API_KEY

See docs/configuration.md for the supported configuration surface.

Verification

Primary local validation commands:

python scripts/validate_harness.py
python scripts/run_harness.py
python scripts/run_live_smoke.py

Docker

docker build -t clickup-mcp:local .
docker run --rm -p 3004:3004 -e API_KEY_MODE=disabled clickup-mcp:local

Documentation

Start with:

For repository workflow and agent-focussed context, read AGENTS.md.

Repository knowledge