ABOUTME: ClickUp MCP integration for task management and workflow automation

ABOUTME: Task CRUD, comments, time tracking, workspace hierarchy, search

ClickUp MCP Integration

Critical Rules

1. •ALL content in English - task names, descriptions, comments
2. •Never guess IDs - always search or ask
3. •Read before update - understand current state
4. •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

1. •Search: clickup_search → keywords
2. •Get details: clickup_get_task → task_id
3. •Check comments: clickup_get_task_comments → find branch name
4. •Update status: clickup_update_task → status: "in progress"
5. •Create branch using name from comment

Workflow: Completing a Task

1. •Add comment: clickup_create_task_comment → "Completed. MR: https://..."
2. •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

1. •Task created → automation adds branch comment
2. •Read comment → get branch name
3. •Work & commit → reference task ID
4. •Create MR → link to task
5. •Update status → "ready for review" → "complete"