# clickup

Manages ClickUp tasks and time from the terminal through an agent. Creates, searches, updates tasks, adds and moves time entries, builds weekly reports.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install
- Author: willmarple
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/willmarple/click-up-skill/tree/HEAD/SKILL.md
- Updated: 2026-01-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/willmarple-clickup

## What it does

The skill provides a CLI for working with ClickUp tasks and time tracking. Inside: commands to search, create, update, delete tasks, add and edit time entries, view weekly reports. Supports table, JSON, or plain text output.

Requires ClickUp API token, workspace ID, user ID, and team ID in `.env`. Token comes from ClickUp settings (Apps → API Token). The `members find` command returns user ID by email, `workspaces list` shows available workspaces.

All operations run through `npm run dev -- <command>`. Examples: `tasks search "billing" --assignee me --table` to search tasks, `time add PROJ-123 --duration "2h 30m"` to log time, `time move <entry_id> --to "2026-01-21"` to move an entry to a different date.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add willmarple/click-up-skill --skill clickup -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/willmarple-clickup/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/willmarple-clickup/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add willmarple/click-up-skill --skill clickup -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/willmarple-clickup/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add willmarple/click-up-skill --skill clickup -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/willmarple-clickup/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install willmarple/click-up-skill willmarple-clickup
```

2. **Manually: put the files in place**
- File: `.github/skills/willmarple-clickup/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add willmarple/click-up-skill --skill clickup -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/willmarple/click-up-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/willmarple-clickup/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add willmarple/click-up-skill --skill clickup -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/willmarple/click-up-skill/tree/HEAD/SKILL.md

## When to use it
- search tasks by text, assignee, or status
- add and edit time entries for tasks
- move time entries to another date
- build weekly time reports
- get user and workspace IDs

## Example prompts
- Find my tasks with `billing` and show as a table
- Add 2 hours 30 minutes to task `PROJ-123` for January 20
- Move time entry `<entry_id>` to January 21

## Similar
- [ClickUp Automation](https://affpapa.org/en/nevibecode/skills/clickup-automation.md) — skill · 5000 installs
- [clickup-automation](https://affpapa.org/en/nevibecode/skills/buildwithclaude-community-clickup-automation.md) — skill · ★ 3785 repo stars
- [asana](https://affpapa.org/en/nevibecode/skills/asana.md) — skill · 1900 installs
- [Astravue MCP](https://affpapa.org/en/nevibecode/mcp/astravue-mcp.md) — MCP server · ★ 12 repo stars
- [astravue](https://affpapa.org/en/nevibecode/plugins/astravue.md) — plugin · ★ 12 repo stars
- [huly-mcp](https://affpapa.org/en/nevibecode/mcp/varaprasadreddy9676-huly-mcp.md) — MCP server · ★ 5 repo stars

## Other versions with the same name
- [clickup · civitai](https://affpapa.org/en/nevibecode/skills/civitai-clickup.md) — 1800 installs
- [clickup · civitai](https://affpapa.org/en/nevibecode/skills/clickup.md) — 1800 installs
- [clickup · membranedev](https://affpapa.org/en/nevibecode/skills/membrane-clickup.md) — 205 installs
- [clickup · krodak](https://affpapa.org/en/nevibecode/skills/krodak-clickup.md) — ★ 132 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
