ABOUTME: ClickUp MCP integration for task management and workflow automation
ABOUTME: Task CRUD, comments, time tracking, workspace hierarchy, search
ClickUp MCP Integration
Critical Rules
- ALL content in English - task names, descriptions, comments
- Never guess IDs - always search or ask
- Read before update - understand current state
- Check comments - automation adds branch names, CI links
Quick Reference
# Search → Get → Update flow
clickup_search → keywords: "task name"
clickup_get_task → task_id: "abc123"
clickup_update_task → task_id, status: "in progress"
clickup_get_task_comments → task_id (check for branch name)
clickup_create_task_comment → task_id, comment_text: "..."All tools available via MCP: clickup_* prefix. See tool schemas for parameters.
Key: Always search before creating. Never guess IDs. create_task requires list_id - ask user.
Workflow: Starting a Task
- Search:
clickup_search→ keywords - Get details:
clickup_get_task→ task_id - Check comments:
clickup_get_task_comments→ find branch name - Update status:
clickup_update_task→ status: "in progress" - Create branch using name from comment
Workflow: Completing a Task
- Add comment:
clickup_create_task_comment→ "Completed. MR: https://..." - Update status:
clickup_update_task→ status: "ready for review"
Git Integration
Branch format from automation: <type>/<task-name>_CU-<task-id>
Example: feature/user-auth_CU-abc123
- Task created → automation adds branch comment
- Read comment → get branch name
- Work & commit → reference task ID
- Create MR → link to task
- Update status → "ready for review" → "complete"