PHPackages                             eduard9969/clickup-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. eduard9969/clickup-php

AbandonedArchivedLibrary[API Development](/categories/api)

eduard9969/clickup-php
======================

Fork ClickUp API client (unofficial)

v1.1.3(4y ago)09696[1 issues](https://github.com/Eduard9969/clickup-php/issues)MITPHPPHP >=7.2

Since Sep 23Pushed 3y agoCompare

[ Source](https://github.com/Eduard9969/clickup-php)[ Packagist](https://packagist.org/packages/eduard9969/clickup-php)[ RSS](/packages/eduard9969-clickup-php/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (6)Dependencies (6)Versions (12)Used By (0)

Fork for the clickup-php
========================

[](#fork-for-the-clickup-php)

[![](https://camo.githubusercontent.com/149fc5e8768e548ce5f164fe8f6fd996d2295d1e7bf2a6e8e72f7ae5034d121f/68747470733a2f2f636c69636b75702e636f6d2f6c616e64696e672f696d616765732f696e746567726174696f6e732f636c69636b75702d6170692d626574612e706e67)](https://camo.githubusercontent.com/149fc5e8768e548ce5f164fe8f6fd996d2295d1e7bf2a6e8e72f7ae5034d121f/68747470733a2f2f636c69636b75702e636f6d2f6c616e64696e672f696d616765732f696e746567726174696f6e732f636c69636b75702d6170692d626574612e706e67)

Fork for the original repo [clickup-php](https://github.com/howyi/clickup-php) | Author: [howyi](https://github.com/howyi)

A simple wrapper for [ClickUp](https://clickup.com/api) API (v1-BETA).

Fork difference:

- Api update to version 2 (in progress)
- Add retries when [rate limit](https://jsapi.apiary.io/apis/clickup20/introduction/rate-limiting.html) is reached (done, thanks [@osiset](https://github.com/osiset/Basic-Shopify-API))
- Add tmp cache for identical requests in a short time (in the plans)

Table of Contents
-----------------

[](#table-of-contents)

- [Installation](#installation)
- [Usage](#usage)
    - [Generate Client](#generate-client)
    - [Get](#get)
    - [Create](#create)
    - [Update](#update)
    - [Storage](#storage)
- [LICENSE](#license)

Installation
------------

[](#installation)

```
composer require eduard9969/clickup-php

```

The package is in development status. I don't want to add another copy of the fork to

Also, You can install the package using [VSC](https://getcomposer.org/doc/05-repositories.md#vcs) in your composer.json. Add the following code:

```
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/Eduard9969/clickup-php.git"
    }
]

```

Usage
-----

[](#usage)

### Generate client

[](#generate-client)

```
// create Option (required: API_TOKEN)
$options = new ClickUp\Options('API_TOKEN');

// create Client (required: ClickUp\Options)
$client = new ClickUp\Client($options);
```

### Get

[](#get)

```
// me
$client->user();
// -> \ClickUp\Objects\User

// all affiliated teams
$client->teams()->objects();
// -> \ClickUp\Objects\Team[]

// team by team id
$team = $client->team($teamId);
// team by name
$team = $client->teams()->getByName('team_name');
// -> \ClickUp\Objects\Team

// spaces in team
$team->spaces()->objects();
// -> \ClickUp\Objects\Space[]

// space by space id
$space = $team->space(888);
// space by name
$space = $team->spaces()->getByName('spaaaaace');
// -> \ClickUp\Objects\Space

// folders in space
$space->folders()->objects();
// -> \ClickUp\Objects\Folder[]

// folder by folder id
$folder = $space->folder(11111);
// folder by name
$folder = $space->folders()->getByName('super cool folder');
// -> \ClickUp\Objects\Folder

// lists in folder
$folder->taskLists()->objects();
// -> \ClickUp\Objects\TaskList[]

// list by list id
$taskList = $folder->taskList(9999);
// list by name
$taskList = $folder->taskLists()->getByName('T A S K L I S T');
// -> \ClickUp\Objects\TaskList

// tasks by list
// @see https://jsapi.apiary.io/apis/clickup20/reference/0/lists/update-list.html
$tasks = $taskList->tasks()->objects();
// -> \ClickUp\Objects\Task[]

// task by task id
$task = $taskList->task(3333);
// -> \ClickUp\Objects\Task

// all tasks with chunks
// tasksChunk get all tasks from the API and execute callback function (arg: $tasks->objects())
$allTasks = [];
$team->tasksChunk(false, false, function($tasks) use (&$allTasks) {
    $allTasks = array_merge($tasks, $allTasks);
    // return false; // break loop
});
// -> true \ false
```

You can use `tasks` and `task` methods on the any level (`$team->tasks(); $space->tasks(); $folder->tasks(); etc`). But remember, 100 is the maximum number of items in the response (not actual for chunk method), I recommend refining the research area.

### Create

[](#create)

```
/**
 * create task list in folder
 * @see https://jsapi.apiary.io/apis/clickup20/reference/0/lists/create-list.html
 * @see https://jsapi.apiary.io/apis/clickup20/reference/0/lists/create-folderless-list.html
 */
$folder->createTaskList(['name' => 'newTaskList']);

/**
 * create task in list
 * @see https://jsapi.apiary.io/apis/clickup20/reference/0/tasks/create-task.html
 */
$taskList->createTask(['name' => 'my second task']);
```

### Update

[](#update)

```
/**
 * update task list
 * @see https://jsapi.apiary.io/apis/clickup20/reference/0/lists/update-list.html
 */
$taskList->edit(['name' => 'renamed task list']);

/**
 * update task
 * @see https://jsapi.apiary.io/apis/clickup20/reference/0/lists/update-list.html
 */
$task->edit(['name' => 'renamed task']);
```

### Storage

[](#storage)

By default retries when rate limit is reached execute via `Memory::Class`. You can use other storage (Implement the `StateStorage` interface) and use custom time deferrer (Implement the `TimeDeferrer` interface).

```
// create Option (required: API_TOKEN)
$options = new ClickUp\Options('API_TOKEN');

// create StoreOptions (optional: StateStorage, StateStorage, TimeDeferrer)
$storeOptions = new ClickUp\StoreOptions($redisTStorage, $redisLStorage, $timeDeferrer);

// create Client (required: ClickUp\Options, optional: ClickUp\StoreOptions)
$client = new ClickUp\Client($options, $storeOptions);
```

LICENSE
-------

[](#license)

This project is released under the MIT [license](https://github.com/Eduard9969/clickup-php/blob/master/LICENSE).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~159 days

Recently: every ~64 days

Total

9

Last Release

1552d ago

Major Versions

v0.0.1 → v1.0.02018-09-25

PHP version history (2 changes)v0.0.1PHP >=5.6

v1.1.0PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/06ad29d7a8750aea9d4b56d4f6ae8531a1b0a98ec1e3ddc14d4ff80cb516b23f?d=identicon)[Eduard9969](/maintainers/Eduard9969)

---

Top Contributors

[![Eduard9969](https://avatars.githubusercontent.com/u/42999756?v=4)](https://github.com/Eduard9969 "Eduard9969 (17 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)")

---

Tags

apiClickUpclick-up

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/eduard9969-clickup-php/health.svg)

```
[![Health](https://phpackages.com/badges/eduard9969-clickup-php/health.svg)](https://phpackages.com/packages/eduard9969-clickup-php)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[moe-mizrak/laravel-openrouter

Laravel package for OpenRouter (A unified interface for LLMs)

157156.6k2](/packages/moe-mizrak-laravel-openrouter)[files.com/files-php-sdk

Files.com PHP SDK

2478.1k](/packages/filescom-files-php-sdk)[clicksend/clicksend-php

301.6M11](/packages/clicksend-clicksend-php)[howyi/clickup-php

ClickUp API client (unofficial)

2925.5k](/packages/howyi-clickup-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

252.5k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)