clickup · willmarple — Claude Code skill: ClickUp tasks and time tracking
Manages ClickUp tasks and time from the terminal through an agent. Creates, searches, updates tasks, adds and moves time entries, builds weekly reports.
no license 1 installs updated 2026-01-27
npx skills add willmarple/click-up-skill --skill clickup -a claude-codeWhat clickup 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.
What it helps with
- 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 for the agent
- Find my tasks with
billingand show as a table - Add 2 hours 30 minutes to task
PROJ-123for January 20 - Move time entry
<entry_id>to January 21
How to install clickup
1Skills CLI (Vercel)
npx skills add willmarple/click-up-skill --skill clickup -a claude-code2Manually: put the files in place
~/.claude/skills/willmarple-clickup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/willmarple-clickup/
1Skills CLI (Vercel)
npx skills add willmarple/click-up-skill --skill clickup -a codex2Manually: put the files in place
.agents/skills/willmarple-clickup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add willmarple/click-up-skill --skill clickup -a cursor2Manually: put the files in place
.cursor/skills/willmarple-clickup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install willmarple/click-up-skill willmarple-clickup2Manually: put the files in place
.github/skills/willmarple-clickup/SKILL.md1Skills CLI (Vercel)
npx skills add willmarple/click-up-skill --skill clickup -a gemini-cli2Platform CLI
gemini skills install https://github.com/willmarple/click-up-skillManually: put the files in place
.devin/skills/willmarple-clickup/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add willmarple/click-up-skill --skill clickup -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about clickup
How to install clickup in Claude Code?
Run npx skills add willmarple/click-up-skill --skill willmarple-clickup -a claude-code, then open ~/.claude/skills/willmarple-clickup/SKILL.md.
What does clickup do?
Manages ClickUp tasks and time from the terminal: search, create, update tasks, add time entries, build weekly reports.
What does clickup need to work?
ClickUp API token, workspace ID, user ID, and team ID in .env file. Token comes from ClickUp settings, user ID can be found with members find command.
Similar skills
All skills for Notes, tasks and projects →clickup by other authors comes first.