ClickUp Integration

Pro v1.0.0

Manage tasks, lists, spaces, and workspaces in ClickUp through the API

Requires Claude Code CLI

This skill integrates with ClickUp through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Get Teams/Workspaces

List all workspaces (teams) the user has access to

Returns

object List of teams with IDs, names, and member information

Try saying...

  • "Show me my ClickUp workspaces"
  • "List all teams I'm in"
  • "What workspaces do I have access to?"

Get User Info

Get information about the authenticated user

Returns

object User details including username, email, and profile info

Try saying...

  • "Show my ClickUp user information"
  • "What's my ClickUp username?"
  • "Get my user details"

List Spaces

Get all spaces in a workspace/team

Parameters

Name Type Required Description
team_id string Required The workspace/team ID

Returns

object List of spaces with IDs, names, and settings

Try saying...

  • "Show me all spaces in team 512"
  • "List spaces for workspace XYZ"
  • "What spaces are in my team?"

List Lists

Get all lists in a folder

Parameters

Name Type Required Description
folder_id string Required The folder ID

Returns

object List of lists with IDs, names, and task counts

Try saying...

  • "Show all lists in folder 789"
  • "What lists are in this folder?"
  • "Get lists for folder ABC"

List Tasks

Get all tasks in a list (limited to 100 per page)

Parameters

Name Type Required Description
list_id string Required The list ID to fetch tasks from
include_closed boolean Optional Include closed/completed tasks

Returns

object Array of tasks with IDs, names, statuses, assignees, and metadata

Try saying...

  • "Show me all tasks in list 456"
  • "Get tasks from my Sprint list"
  • "What tasks are in the backlog?"
  • "List all open tasks including closed ones"

Get Task

Get details about a specific task by ID

Parameters

Name Type Required Description
task_id string Required The task ID

Returns

object Complete task details including description, custom fields, time tracking, and comments

Try saying...

  • "Show me task abc123"
  • "Get details for task ID xyz"
  • "What's in task #123?"

Create Task

Create a new task in a list

Parameters

Name Type Required Description
list_id string Required The list ID where the task will be created
name string Required The task name/title
description string Optional Task description (supports markdown)

Returns

object The created task object with ID and all fields

Try saying...

  • "Create a task called 'Review PR' in list 456"
  • "Add a new task 'Fix bug' to the Sprint list"
  • "Create task 'Write documentation' with description 'Add API docs'"

Update Task

Update an existing task's name or status

Parameters

Name Type Required Description
task_id string Required The task ID to update
name string Optional New task name
status string Optional New status (e.g., 'in progress', 'complete', 'to do')

Returns

object The updated task object

Try saying...

  • "Update task abc to status 'in progress'"
  • "Rename task xyz to 'New Name'"
  • "Mark task 123 as complete"
  • "Change task status to done"

Getting Started

API Key Easy Setup
  1. 1 Log into ClickUp and click your avatar (upper-right corner)
  2. 2 Select Settings → Apps
  3. 3 Under API Token, click Generate (or Regenerate)
  4. 4 Copy the token (starts with pk_)
  5. 5 Add to shell config: echo 'export CLICKUP_API_KEY="YOUR_KEY"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py get-user

Success: Returns user information with username and email

View full setup guide

Security & Access

Access Scope

Full access to all ClickUp workspaces and tasks that the authenticated user has permissions to view or modify

  • API token grants the same level of access as your user account
  • Token can create, update, and delete tasks across all accessible workspaces
  • Token never expires - rotate periodically by regenerating
  • Keep token secure and never commit to version control
  • Consider using workspace-specific permissions to limit access

Limitations

  • Task list responses limited to 100 tasks per page
  • Personal API tokens have same permissions as the user account
  • No built-in pagination support in current client (returns first page only)

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements