Clickup Ticket

Overview

Fetch, filter, and create ClickUp tickets directly from Claude Code or Codex. Read tickets by ID, filter by status/assignee/tags/dates, view your assigned tickets, create tickets interactively, and manage multi-org workspaces with intelligent caching.

This skill ships inside the ClickUp Ticket Manager plugin and can be installed through the Claude Code marketplace or directly in Codex from its skill path.

Parent Surface

Parent docs: ClickUp Ticket Manager

Related wrapper commands from the parent plugin:

When to Use This Skill

Use this skill when you want to:

This skill is designed to feel personalized: it learns your workspace structure, remembers your defaults, and asks simple questions when it needs information.

• Fetch ticket details by ID or URL to understand requirements
• List and filter tickets by status, assignee, tags, due dates, and more
• View your assigned tickets with smart grouping by urgency
• Create tickets without leaving your terminal or IDE
• Add subtasks to existing tickets during development
• Quick-add to backlog when you spot TODOs or tech debt
• Manage multiple ClickUp organizations (work, personal, clients)
• Discover your workspace structure (spaces, lists, tags, members)

Prerequisites

Generate a personal API token:

Add to your shell profile (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish):

Then reload your shell:

Note: If you have multiple ClickUp accounts, you can set up additional tokens. See Usage workflows for the multi-org flow.

export CLICKUP_TICKET_SKILL_TOKEN="pk_12345_XXXXXXXXXX"

source ~/.bashrc  # or restart your terminal

Quick Start

/clickup-ticket:configure

/clickup-ticket:create-ticket

/clickup-ticket:quick-ticket "Fix login timeout bug"

/clickup-ticket:add-to-backlog "Refactor auth module"

Core Concepts

Key points:

This skill supports multiple ClickUp organizations:

Each organization has its own:

Switch between orgs with /clickup-ticket:switch-org.

The skill caches your workspace data locally for fast access:

Cache location: ~/.config/clickup-ticket/ (shared by Claude Code and Codex)

Cache refresh:

• Every task belongs to a List
• Lists can be inside Folders or directly in a Space
• Spaces belong to a Workspace (organization)
• You need a list_id to create a task
• Work - Your company's workspace
• Personal - Your personal ClickUp
• Clients - Client workspaces you have access to
• Cached workspace data (spaces, lists, tags, members)
• Default settings (list, assignee, priority)
• Optional separate API token
• Workspace structure - Spaces, folders, lists
• Team members - Names, emails, IDs for assignment
• Tags - Available tags per space
• Statuses - Available statuses per list
• Auto-refreshes after 24 hours
• Manual refresh: /clickup-ticket:refresh-cache
• Refreshes automatically if an entity is not found

Workspace (Organization)
  └── Space (e.g., "Engineering", "Product")
       ├── Folder (optional grouping)
       │    └── List (e.g., "Auth Refactor")
       │         └── Task
       │              └── Subtask
       └── List (standalone, e.g., "Backlog")
            └── Task
                 └── Subtask

Resources

Declared allowed tools:

Installation

Switch between Claude Code and Codex, then copy the install command for the runtime you use.

claude plugin marketplace add DiversioTeam/agent-skills-marketplace
claude plugin install clickup-ticket@diversiotech

CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo DiversioTeam/agent-skills-marketplace \
  --path plugins/clickup-ticket/skills/clickup-ticket

Invocation:

/clickup-ticket:get-ticket
/clickup-ticket:create-ticket
/clickup-ticket:my-tickets
/clickup-ticket:quick-ticket
/clickup-ticket:list-tickets
/clickup-ticket:configure
/clickup-ticket:add-org
/clickup-ticket:switch-org
/clickup-ticket:refresh-cache
/clickup-ticket:create-subtask
/clickup-ticket:list-spaces
/clickup-ticket:add-to-backlog

name: clickup-ticket