使用说明
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_TOKENCLICKUP_TEAM_IDCLICKUP_MCP_API_KEYorMCP_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
- Documentation map — RKE-managed reading order and relationship hub.
