How do I install the Clickup skill?

Run npx skillmds@latest add modbender/clickup-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Clickup safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clickup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clickup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clickup?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clickup by modbender — Agent Skill

Name: Clickup
Author: modbender

File contents

ClickUp Integration

Credentials

Note: Configure your credentials in TOOLS.md or set environment variables:

CLICKUP_API_TOKEN - Your ClickUp API token
CLICKUP_WORKSPACE_ID - Your ClickUp workspace ID

User Assignment Guide

When assigning tasks, use the correct email based on who should do the work:

Email	Who	Use When
`your-email@example.com`	Human	Tasks for you to do manually
`ai-assistant@example.com`	AI Assistant	Tasks for AI to execute
Both emails	Both Human + AI	Collaborative tasks where AI does research/writing, human reviews/decides

Examples

AI-only task: "Research trend detection tools" → Assign to AI email
Human-only task: "Record video for YouTube" → Assign to your email
Collaborative: "Create content strategy" → Assign to both

Common Actions

List Tasks in a List

GET https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}

Get All Tasks in Workspace

GET https://api.clickup.com/api/v2/team/{workspace_id}/task
Authorization: {your_api_token}

Create Task

POST https://api.clickup.com/api/v2/list/{list_id}/task
Authorization: {your_api_token}
Content-Type: application/json

{
  "name": "Task name",
  "description": "Task description",
  "status": "active"
}

Update Task Status

PUT https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}
Content-Type: application/json

{
  "status": "done"
}

Get Task Details

GET https://api.clickup.com/api/v2/task/{task_id}
Authorization: {your_api_token}

Headers for All Requests

Authorization: {your_api_token}
Content-Type: application/json

Status Values

Common statuses: active, pending, review, completed, done

Error Handling

401: Check API token
404: Verify list_id or task_id exists
429: Rate limited - wait before retrying

---name: clickup-2description: Interact with ClickUp API for task management. Use for listing tasks, creating tasks, updating task status, and managing workspaces. Base URL: https://api.clickup.com/api/v2---# ClickUp Integration## Credentials**Note:** Configure your credentials in TOOLS.md or set environment variables:- `CLICKUP_API_TOKEN` - Your ClickUp API token- `CLICKUP_WORKSPACE_ID` - Your ClickUp workspace ID## User Assignment GuideWhen assigning tasks, use the correct email based on who should do the work:| Email | Who | Use When ||-------|-----|----------|| `your-email@example.com` | **Human** | Tasks for you to do manually || `ai-assistant@example.com` | **AI Assistant** | Tasks for AI to execute || Both emails | **Both Human + AI** | Collaborative tasks where AI does research/writing, human reviews/decides |### Examples- **AI-only task**: "Research trend detection tools" → Assign to AI email- **Human-only task**: "Record video for YouTube" → Assign to your email- **Collaborative**: "Create content strategy" → Assign to both## Common Actions### List Tasks in a List```httpGET https://api.clickup.com/api/v2/list/{list_id}/taskAuthorization: {your_api_token}```### Get All Tasks in Workspace```httpGET https://api.clickup.com/api/v2/team/{workspace_id}/taskAuthorization: {your_api_token}```### Create Task```httpPOST https://api.clickup.com/api/v2/list/{list_id}/taskAuthorization: {your_api_token}Content-Type: application/json{ "name": "Task name", "description": "Task description", "status": "active"}```### Update Task Status```httpPUT https://api.clickup.com/api/v2/task/{task_id}Authorization: {your_api_token}Content-Type: application/json{ "status": "done"}```### Get Task Details```httpGET https://api.clickup.com/api/v2/task/{task_id}Authorization: {your_api_token}```## Headers for All Requests```Authorization: {your_api_token}Content-Type: application/json```## Status ValuesCommon statuses: `active`, `pending`, `review`, `completed`, `done`## Error Handling- 401: Check API token- 404: Verify list_id or task_id exists- 429: Rate limited - wait before retrying

Frequently asked questions

Clickup