npm install -g @krodak/clickup-cli && cup init
For AI Agents
Paste this into any AI agent (Claude Code, Codex, Cursor, OpenCode, etc.):
Install and configure the ClickUp CLI for me. Fetch the setup guide from:
https://raw.githubusercontent.com/krodak/clickup-cli/main/skills/clickup-cli/SKILL.md
Then walk me through installing the CLI, getting a ClickUp API token,
and running cup init. Finally, install the skill with `cup skill` so
you have persistent access to the full command reference.
The fetched SKILL.md contains everything the agent needs: install commands,
where to get a ClickUp API token, non-interactive setup with cup init --token --team,
and the complete command reference. After setup, the agent can run any cup command
to manage your tasks, sprints, comments, time tracking, and more.
Already have the CLI installed? Just run cup skill to install the agent skill to
all detected locations (see Set up your agent below).
Talk to your agent
Install the CLI, add the skill file to your agent, and it works with ClickUp. No API knowledge needed.
"Read task abc123, do the work, then mark it in review and leave a comment with the commit hash."
"What's my standup? What did I finish, what's in progress, what's overdue?"
"Create a subtask under the initiative for the edge case we found."
"Check my sprint and tell me what's behind schedule."
"Update the description with your findings and flag blockers in a comment."
The agent reads the skill file, picks the right cup commands, and handles everything. You don't need to learn the CLI - the agent does.
Terminal mode (TTY)
Task listing commands (cup tasks, cup search, cup sprint, etc.) present an interactive picker — navigate with arrow keys or j/k, Space to select tasks, Enter to confirm. Selected tasks show full details and offer to open in the browser. Other prompts (sprint disambiguation, delete confirmations) also use interactive selection.
Agent / piped mode
When piped (no TTY), the same commands output clean Markdown (or JSON with --json). No prompts, no colors — designed for agents and pipelines.
Why a CLI and not MCP?
A CLI + skill file has fewer moving parts. No server process, no protocol layer. The agent already knows how to run shell commands - the skill file teaches it which ones exist. For tool-use with coding agents, CLI + instructions tends to work better than MCP in practice.
Install
You need Node 22+ and a ClickUp personal API token (pk_... from ClickUp Settings > Apps).
npm
npm install -g @krodak/clickup-cli
cup init
cup auth # verify setup
Homebrew
brew tap krodak/tap
brew install clickup-cli
cup init
cup auth # verify setup
Set up your agent
After installing cup, run:
cup skill
This detects which agents you have (Claude Code, Codex, OpenCode) and installs the skill file to the right locations. Run it again after updating cup to refresh the skill.
Manual install options
Claude Code
Install as a plugin (recommended):
claude plugin add $(npm root -g)/@krodak/clickup-cli
Or as a personal skill:
cup skill --path ~/.claude/skills/clickup/SKILL.md