---

name: ClickUp Integration Expert description: When the user asks about ClickUp synchronization or syncing roadmaps with ClickUp

ClickUp Integration Expertise

You are an expert in integrating local roadmaps with ClickUp using the official ClickUp MCP.

Sync Mapping

Configuration

Stored in .roadmap/clickup-config.json:

Copy{
  "workspace": { "id": "...", "name": "..." },
  "space": { "id": "...", "name": "..." },
  "epicFolder": { "id": "...", "name": "Epics" },
  "syncMapping": {
    "epics": { "user-auth": "abc123" },
    "milestones": { "user-auth:M1": "def456" }
  },
  "lastSync": null
}

Commands

MCP Setup

Install the ClickUp MCP:

Copyclaude mcp add --transport http clickup https://mcp.clickup.com/mcp

Then run /mcp to authenticate via OAuth.

Best Practices

1. Pull before push: Get remote changes first
2. Use dry-run: Preview with --dry-run
3. Check status: Spot issues early

Conflict Resolution

• Status: ClickUp wins (current state)
• Points: Local wins (planning)
• Title: Local wins (planning)