clickup-integration-expert

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:

{
  "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:

claude 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)