Pp Clickup

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/project-management/clickup/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

ClickUp — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the clickup-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install clickup --cli-only

2. Verify: clickup-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/project-management/clickup/cmd/clickup-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

172 endpoints across the v2 reference (Tasks, Spaces, Folders, Lists, Goals, Time Tracking, Webhooks, Comments, Custom Fields, Members, Templates, Views) and the v3 public API (Chat, Docs, Audit Logs, ACLs). Hierarchical sync walks the full workspace tree into local SQLite for offline search and analytics. Top-level docs and chat commands give you idiomatic verbs without remembering the workspaces/<verb>-public spec path.

When to Use This CLI

Use clickup-pp-cli when you need to script against the full ClickUp v2 + v3 surface, populate a local SQLite store for offline analytics across a workspace's full hierarchy, or expose ClickUp as an MCP server to an agent. Particularly useful for time-tracking aggregation, sprint reporting, and bulk task operations that the web UI doesn't surface.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• sync — Walks the full ClickUp hierarchy in dependency order (teams → spaces → folders → lists → tasks; teams → docs; teams → channels) and lands every record in the local SQLite store. Every parent-child relationship in the API is traversed automatically.

  Reach for this when you want offline search, analytics, or any compound query across a ClickUp workspace's full structure. One command populates the entire tree.

  clickup-pp-cli sync --json --profile default

• sync — Distinguishes "recognized envelope with empty array" from "unrecognized response shape" so tenants with zero records of a resource type sync cleanly instead of crashing. ClickUp returns {"spaces":[]} for workspaces with no spaces; the original framework treated this as a singular response and tried to upsert the wrapper as a single record, failing with "missing id for space".

  Without this, sync silently fails for any workspace with empty resource collections, leaving the local store partially populated.

  clickup-pp-cli sync --resources space --profile default --json

Agent-native plumbing

• docs — Top-level docs and chat commands with idiomatic verbs (search, get, pages, page, listing, create, edit, send, react, reply, members, followers, messages) replacing the spec-derived workspaces/docs/<verb>-public and workspaces/chat/get-channels paths. ~22 aliases total. Original verbs kept as Cobra aliases for back-compat.

  Reach for docs search, chat list, chat send directly instead of remembering the deeply-nested workspaces tree. Especially useful when scripting against v3 endpoints.

  clickup-pp-cli docs search 9017321407 --json --profile default

• task attach — Upload one or more local files to a task as real multipart/form-data (one POST per file, part field attachment, per-file MIME type). Accepts custom task IDs via --custom-task-ids --team-id, validates every file before sending anything, and --dry-run previews the upload without sending.

  Reach for this when an agent needs to put a local file (report, screenshot, export) onto a ClickUp task.

  clickup-pp-cli task attach abc123xyz ./report.pdf --dry-run --json

• task attachments — List a task's attachments as rows (id, title, extension, size, url, total_comments, resolved_comments, open_comments) from GET /v2/task/{id}, with custom task ID support.

  Reach for this to see which attached documents still have unresolved review comments.

  clickup-pp-cli task attachments abc123xyz --json

Command Reference

checklist — Manage checklist

• clickup-pp-cli checklist delete — Delete a checklist from a task.
• clickup-pp-cli checklist edit — Rename a task checklist, or reorder a checklist so it appears above or below other checklists on a task.

comment — Manage comment

• clickup-pp-cli comment delete — Delete a task comment.
• clickup-pp-cli comment update — Replace the content of a task commment, assign a comment, and mark a comment as resolved.

folder — Manage folder

• clickup-pp-cli folder delete — Delete a Folder from your Workspace.
• clickup-pp-cli folder get — View the Lists within a Folder.
• clickup-pp-cli folder update — Rename a Folder.

goal — Manage goal

• clickup-pp-cli goal delete — Remove a Goal from your Workspace.
• clickup-pp-cli goal get — View the details of a Goal including its Targets.
• clickup-pp-cli goal update — Rename a Goal, set the due date, replace the description, add or remove owners, and set the Goal color.

group — Manage group

• clickup-pp-cli group delete-team — This endpoint is used to remove a [User Group](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-...
• clickup-pp-cli group get-teams1 — This endpoint is used to view [User Groups](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-gro...
• clickup-pp-cli group update-team — This endpoint is used to manage [User Groups](https://docs.clickup.com/en/articles/4010016-teams-how-to-create-user-g...

key-result — Manage key result

• clickup-pp-cli key-result delete — Delete a target from a Goal.
• clickup-pp-cli key-result edit — Update a Target.

list — Manage list

• clickup-pp-cli list delete — Delete a List from your Workspace.
• clickup-pp-cli list get — View information about a List.
• clickup-pp-cli list update — Rename a List, update the List Info description, set a due date/time, set the List's priority, set an assignee, set...

oauth — Manage oauth

• clickup-pp-cli oauth — These are the routes for authing the API and going through the OAuth flow. Applications...

space — Manage space

• clickup-pp-cli space delete — Delete a Space from your Workspace.
• clickup-pp-cli space get — View the Spaces available in a Workspace.
• clickup-pp-cli space update — Rename, set the Space color, and enable ClickApps for a Space.

task — Manage task

• clickup-pp-cli task attach — Upload one or more local files to a task as attachments (multipart/form-data)
• clickup-pp-cli task attachments — List a task's attachments with size, URL and comment counts (total/resolved/open)
• clickup-pp-cli task delete — Delete a task from your Workspace.
• clickup-pp-cli task get — View information about a task. You can only view task information of tasks you can access. Tasks with attachments...
• clickup-pp-cli task get-bulk-timein-status — View how long two or more tasks have been in each status. The Total time in Status ClickApp must first be enabled by...
• clickup-pp-cli task update — Update a task by including one or more fields in the request body.

team — Manage team

• clickup-pp-cli team — View the Workspaces available to the authenticated user.

user — Manage user

• clickup-pp-cli user — View the details of the authenticated user's ClickUp account.

view — Manage view

• clickup-pp-cli view delete — Delete View
• clickup-pp-cli view get — View information about a specific task or page view. The information returned about a view varies by the type of view.
• clickup-pp-cli view update — Rename a view, update the grouping, sorting, filters, columns, and settings of a view.

webhook — Manage webhook

• clickup-pp-cli webhook delete — Delete a webhook to stop monitoring the events and locations of the webhook.
• clickup-pp-cli webhook update — Update a webhook to change the events to be monitored.

workspaces — Manage workspaces