skills.rest
timi-ty
timi-tyCOMMUNITY
Explore all skills by this author →
Website𝕏@glasses_0_0_manGitHub

clickup

Connects AI coding agents to the ClickUp REST API for querying tasks, comments, and attachments.

Updated Mar 6, 2026
Search Tags:#task management#project setup#claude code#api integration#rest api#clickup#cursor
One-click install
npx skills add https://github.com/timi-ty/agent-forge --skill clickup-timi-ty
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clickup
Source: https://github.com/timi-ty/agent-forge/tree/main/skills/clickup
Command: npx skills add https://github.com/timi-ty/agent-forge --skill clickup-timi-ty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers working in Cursor or Claude Code must constantly switch to the ClickUp browser tab to read task requirements, check sprint status, or view attachments. This Skill provisions ClickUp credentials, links a ClickUp view to the current project, and gives the agent direct API access so task context arrives in the editor instead of the browser. ## Core Features & Use Cases - Credential provisioning and view linking: Validates a ClickUp Personal API Token, parses view or workspace URLs, and writes Team ID and View ID into the project's CLAUDE.md. - Direct API query helper: Fetches tasks (with status/assignee filters and 5-minute caching), full task details, comment threads, workspace-wide search, attachment downloads, and list statuses — all as JSON on stdout. - Sub-commands for lifecycle management: Change the linked view, reconfigure credentials, or remove the ClickUp association from a project without touching global credentials. - Use Case: You tell your agent "work on PROJ-123". The agent calls the query helper to fetch the task description, acceptance criteria, and comment thread, then starts coding with full context — no browser required. ## Quick Start Ask your agent to set up ClickUp by saying "set up clickup" and paste your Personal API Token and a ClickUp view URL when prompted.

Frequently Asked Questions about clickup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect ClickUp to Cursor or Claude Code?▼

Run the setup flow by saying "set up clickup" to your agent. It will ask for your ClickUp Personal API Token (generated under ClickUp avatar → Settings → Apps → Generate) and a view or workspace URL, then validate both and write the configuration to your project's CLAUDE.md.

How do I query ClickUp tasks from the command line?▼

Use the query helper with commands like node query/index.mjs tasks, task <id>, comments <id>, or search <query>. It reads the API token from ~/.clickup/.env and the Team/View IDs from the nearest CLAUDE.md, returning JSON on stdout.

Does the ClickUp integration require an MCP server?▼

No MCP server or external dependencies are required. The integration uses plain Node.js (version 18 or higher) with the built-in fetch API to call the ClickUp REST API v2 directly.

Why does ClickUp API querying fail with rate limit errors?▼

ClickUp enforces 100 requests per minute per token. The helper automatically retries on HTTP 429 with exponential backoff up to 3 times, but fails fast with an actionable error if ClickUp demands a wait longer than 60 seconds.

Can I download private ClickUp attachments from the API?▼

Yes. The download-attachment command always sends the API token with the request, so it works both for publicly accessible attachment URLs and for workspaces that have enabled Private Attachment Links.

How do I change which ClickUp view is linked to my project?▼

Say "change clickup view" to your agent. It will ask for a new view URL (or a workspace URL to browse available views), validate access, and update the Team ID and View ID lines in your project's CLAUDE.md without touching stored credentials.

Related Skills

Explore More Software Engineering Skills→
hmzainjamilhmzainjamil
1

ClickUp Automation

Create, update, and organize ClickUp tasks, lists, spaces, time entries, and goals.

Community
Advanced
mpazarynampazaryna
1

open

Fetch a ClickUp task, assess readiness, and create a Git branch.

Community
Advanced
duongtdnduongtdn

replan

Synchronize GitHub milestones with local sprint tracking files.

Community
Advanced
wooyekwooyek

dev10x-linear

Access Linear issue tracker operations via MCP tools for retrieval, creation, updates, and comments.

Community
Intermediate