clickup-integration-expert

When the user asks about ClickUp synchronization or syncing roadmaps with ClickUp

Stars 232

Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/andresnaza/clickup-integration-expert

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:

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:

bash

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

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