# Clickup

List ClickUp workspaces and tasks, and create tasks.

- Repository: https://github.com/Anil-matcha/awesome-muse-connectors (1403 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Anil-matcha/awesome-muse-connectors --skill clickup -g -a claude-code -y`
Codex: `npx skills add Anil-matcha/awesome-muse-connectors --skill clickup -g -a codex -y`
Cursor: `npx skills add Anil-matcha/awesome-muse-connectors --skill clickup -g -a cursor -y`
Gemini CLI: `npx skills add Anil-matcha/awesome-muse-connectors --skill clickup -g -a gemini-cli -y`

## Description

List ClickUp workspaces and tasks, and create tasks. Trigger phrases: clickup, clickup tasks, my clickup list.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ClickUp

## Purpose
Work the user's ClickUp: list workspaces ("teams") (`teams`), list tasks in a list (`tasks`), and create tasks (`create`). ClickUp's API calls workspaces "teams": `teams` returns workspaces.

## Tooling
All commands go through `bin/clickup.py`:

```bash
bin/clickup.py teams                    # workspaces (id, name)
bin/clickup.py tasks --list 123456789   # tasks in a list (name, status, due date)
bin/clickup.py create --list 123456789 --name "Ship the thing"   # create a task
```

List ids come from ClickUp (open a list → the URL contains its numeric id). Use `teams` → space → folder → list navigation in ClickUp's UI to find the right list.

## Auth
- Provider id: `clickup` (credential is collected as `custom.clickup`)
- Collection: personal API token via the secure credential flow (`credentials.request_api_access`): create one in ClickUp → avatar → Settings → Apps → API Token (tokens start with `pk_`)
- Connect placement: `custom_header:Authorization` (ClickUp takes the **raw** token in the `Authorization` header: no `Bearer` prefix)
- Allowed hosts: `api.clickup.com`
- Status check: `bin/clickup.py teams` (a successful list proves the token works)

## Operating Rules
1. `create` is a write: confirm the task name and destination list with the user before running, unless standing permission exists.
2. Reading (`teams`, `tasks`) needs no confirmation.
3. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/clickup.py`). Do not print, log, or transmit the token value.

## Files
- SKILL.md
- bin/clickup.py

## Maturity
🧪 Draft: written from ClickUp's public API v2 docs; not yet live-tested end-to-end.