The README names what it does not cover — Docs, whiteboards, dashboards, automations, goals, attachments, webhooks, calendar views — and puts coverage at roughly 30-40% of the ClickUp API. That trade buys a tool surface aimed at the daily loop, with bulk operations and flexible id parsing that make agent-driven edits practical. There is no built-in rate limiting against ClickUp's 100 requests per minute, so a large bulk run is the place to be careful.
An MCP server over the ClickUp API v2 that deliberately covers task management rather than all of ClickUp. It handles tasks, lists, comments, assignments, time tracking and team analytics, and accepts task references in whatever form you already have them — a standard id, a custom id like `gh-123`, a `#123` hash, or a pasted ClickUp URL.
- Task CRUD plus two shortcuts that are awkward in the UI: `create_task_from_template` for bug-report, feature-request and code-review shapes, and `create_task_chain` for a sequence of dependent tasks
- Finding work: `list_tasks`, `search_tasks`, `get_subtasks`, and `find_list_by_name` so a list can be named rather than looked up by id
- Bulk edits in one call — `bulk_update_tasks` and `bulk_move_tasks` across many tasks at once
- Time tracking with `log_time` and `get_time_tracked`, and two reporting tools: `get_team_workload` for distribution across members and `get_task_analytics` for velocity and completion rates
- People handling that does not need ids: `find_user_by_name` resolves a name or email, then `assign_task` attaches them
- Comments through `get_task_comments` and `create_task_comment`
A ClickUp personal API token, generated under Settings → Apps → API and shown only once. Store it with `uvx clickup-mcp set-api-key` or export `CLICKUP_MCP_API_KEY`. Python 3.10+. The package is `clickup-mcp` (0.1.0 in pyproject), run with `uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp`. The token carries the same permissions as your own account. MIT licensed.
One command plus a key — uvx --from git+https://github.com/DiversioTeam/clickup-mcp clickup-mcp, then supply credentials
