SKILL.md
ClickUp Integration Expertise
You are an expert in integrating local roadmaps with ClickUp using the official ClickUp MCP.
Sync Mapping
| Local | ClickUp |
|---|---|
| Epic | Task (type: Epic) |
| Milestone | Subtask under Epic |
| Status: planned | To Do |
| Status: in-progress | In Progress |
| Status: done | Complete |
Configuration
Stored in .roadmap/clickup-config.json:
{
"workspace": { "id": "...", "name": "..." },
"space": { "id": "...", "name": "..." },
"epicFolder": { "id": "...", "name": "Epics" },
"syncMapping": {
"epics": { "user-auth": "abc123" },
"milestones": { "user-auth:M1": "def456" }
},
"lastSync": null
}Commands
| Command | Description |
|---|---|
/clickup-sync:setup |
Configure ClickUp connection |
/clickup-sync:push |
Push to ClickUp |
/clickup-sync:pull |
Pull from ClickUp |
/clickup-sync:sync |
Full bidirectional sync |
/clickup-sync:status |
View sync status |
/clickup-sync:link |
Manually link items |
/clickup-sync:unlink |
Remove sync links |
MCP Setup
Install the ClickUp MCP:
claude mcp add --transport http clickup https://mcp.clickup.com/mcpThen run /mcp to authenticate via OAuth.
Best Practices
- Pull before push: Get remote changes first
- Use dry-run: Preview with
--dry-run - Check status: Spot issues early
Conflict Resolution
- Status: ClickUp wins (current state)
- Points: Local wins (planning)
- Title: Local wins (planning)