@chykalophia/clickup-mcp-server 3.2.0 → 3.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +68 -31
- package/build/index-efficiency-simple.js +1 -1
- package/build/index-enhanced.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
</p>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
|
-
<a href="https://www.npmjs.com/package/clickup-mcp-server"><img src="https://img.shields.io/npm/v/clickup-mcp-server.svg" alt="npm version"></a>
|
|
8
|
+
<a href="https://www.npmjs.com/package/@chykalophia/clickup-mcp-server"><img src="https://img.shields.io/npm/v/@chykalophia/clickup-mcp-server.svg" alt="npm version"></a>
|
|
9
9
|
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
|
|
10
10
|
<a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen" alt="Node.js Version"></a>
|
|
11
11
|
<a href="https://github.com/modelcontextprotocol/typescript-sdk"><img src="https://img.shields.io/badge/MCP%20SDK-1.6.1-orange" alt="MCP SDK"></a>
|
|
@@ -13,6 +13,8 @@
|
|
|
13
13
|
|
|
14
14
|
A comprehensive Model Context Protocol (MCP) server providing AI assistants with complete ClickUp API access. Features **170+ tools**, **AI-powered efficiency**, **production-grade security**, and **full GitHub Flavored Markdown support**.
|
|
15
15
|
|
|
16
|
+
> **📦 Quick Install**: `npx @chykalophia/clickup-mcp-server` - No build required!
|
|
17
|
+
|
|
16
18
|
## 📋 Attribution
|
|
17
19
|
|
|
18
20
|
This Enhanced version is based on the original ClickUp MCP Server codebase by [David Whatley](https://davidwhatley.com) at [nsxdavid/clickup-mcp-server](https://github.com/nsxdavid/clickup-mcp-server).
|
|
@@ -173,12 +175,49 @@ interface User {
|
|
|
173
175
|
}
|
|
174
176
|
```
|
|
175
177
|
|
|
176
|
-
## Installation
|
|
178
|
+
## 🚀 Easy Installation
|
|
179
|
+
|
|
180
|
+
### Option 1: One-Click Installer (Recommended)
|
|
181
|
+
|
|
182
|
+
Download and run the automated installer:
|
|
183
|
+
|
|
184
|
+
```bash
|
|
185
|
+
curl -O https://raw.githubusercontent.com/Chykalophia/ClickUp-MCP-Server---Enhanced/main/clickup-installer.js
|
|
186
|
+
node clickup-installer.js
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
Or via NPX:
|
|
190
|
+
```bash
|
|
191
|
+
npx clickup-mcp-installer
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
### Option 2: Web Configurator
|
|
195
|
+
|
|
196
|
+
Visit the web-based configurator for visual setup:
|
|
197
|
+
[ClickUp MCP Configurator](https://chykalophia.github.io/ClickUp-MCP-Server---Enhanced/configurator.html)
|
|
198
|
+
|
|
199
|
+
1. Select your preferred version
|
|
200
|
+
2. Enter your ClickUp API token
|
|
201
|
+
3. Download the generated config file
|
|
202
|
+
4. Place it in your Claude Desktop config directory
|
|
203
|
+
|
|
204
|
+
### Option 3: NPM Package (Manual Setup)
|
|
205
|
+
|
|
206
|
+
Use the published npm package - no build required:
|
|
207
|
+
|
|
208
|
+
```
|
|
209
|
+
@chykalophia/clickup-mcp-server
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### Option 4: Build from Source
|
|
213
|
+
|
|
214
|
+
For development or customization:
|
|
177
215
|
|
|
178
216
|
```bash
|
|
179
|
-
git clone https://github.com/
|
|
180
|
-
cd
|
|
217
|
+
git clone https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git
|
|
218
|
+
cd ClickUp-MCP-Server---Enhanced
|
|
181
219
|
npm install
|
|
220
|
+
npm run build
|
|
182
221
|
```
|
|
183
222
|
|
|
184
223
|
## Get ClickUp API Token
|
|
@@ -192,30 +231,34 @@ npm install
|
|
|
192
231
|
|
|
193
232
|
Add to the MCP settings file:
|
|
194
233
|
|
|
195
|
-
###
|
|
234
|
+
### 🚀 Quick Setup Configuration
|
|
235
|
+
|
|
236
|
+
#### NPM Package (Recommended) ⭐
|
|
196
237
|
```json
|
|
197
238
|
{
|
|
198
239
|
"mcpServers": {
|
|
199
240
|
"clickup": {
|
|
200
|
-
"command": "
|
|
201
|
-
"args": ["/
|
|
241
|
+
"command": "npx",
|
|
242
|
+
"args": ["-y", "@chykalophia/clickup-mcp-server"],
|
|
202
243
|
"env": {
|
|
203
244
|
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
|
|
204
|
-
}
|
|
205
|
-
"disabled": false,
|
|
206
|
-
"autoApprove": []
|
|
245
|
+
}
|
|
207
246
|
}
|
|
208
247
|
}
|
|
209
248
|
}
|
|
210
249
|
```
|
|
211
250
|
|
|
212
|
-
###
|
|
251
|
+
### 🔧 Build from Source (Advanced Users)
|
|
252
|
+
|
|
253
|
+
If you prefer to build from source:
|
|
254
|
+
|
|
255
|
+
#### Standard Version
|
|
213
256
|
```json
|
|
214
257
|
{
|
|
215
258
|
"mcpServers": {
|
|
216
259
|
"clickup": {
|
|
217
260
|
"command": "node",
|
|
218
|
-
"args": ["/path/to/clickup-mcp-server/build/index-
|
|
261
|
+
"args": ["/path/to/clickup-mcp-server/build/index-enhanced.js"],
|
|
219
262
|
"env": {
|
|
220
263
|
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
|
|
221
264
|
},
|
|
@@ -226,22 +269,13 @@ Add to the MCP settings file:
|
|
|
226
269
|
}
|
|
227
270
|
```
|
|
228
271
|
|
|
229
|
-
|
|
230
|
-
* Make sure to supply your API token
|
|
231
|
-
|
|
232
|
-
## Alternate Installation (npx)
|
|
233
|
-
|
|
234
|
-
For users who prefer not to clone the repository, the package can be run directly using npx:
|
|
235
|
-
|
|
272
|
+
#### Enhanced Efficiency Version ⭐
|
|
236
273
|
```json
|
|
237
274
|
{
|
|
238
275
|
"mcpServers": {
|
|
239
276
|
"clickup": {
|
|
240
|
-
"command": "
|
|
241
|
-
"args": [
|
|
242
|
-
"-y",
|
|
243
|
-
"clickup-mcp-server"
|
|
244
|
-
],
|
|
277
|
+
"command": "node",
|
|
278
|
+
"args": ["/path/to/clickup-mcp-server/build/index-efficiency-simple.js"],
|
|
245
279
|
"env": {
|
|
246
280
|
"CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
|
|
247
281
|
},
|
|
@@ -252,8 +286,11 @@ For users who prefer not to clone the repository, the package can be run directl
|
|
|
252
286
|
}
|
|
253
287
|
```
|
|
254
288
|
|
|
255
|
-
|
|
256
|
-
|
|
289
|
+
### 📝 Configuration Notes
|
|
290
|
+
|
|
291
|
+
* **Replace `YOUR_API_TOKEN_HERE`** with your actual ClickUp API token
|
|
292
|
+
* **NPM method** requires no installation or cloning - the package is downloaded automatically
|
|
293
|
+
* **Build from source** requires cloning this repository and running `npm run build`
|
|
257
294
|
|
|
258
295
|
## Configuration File Locations
|
|
259
296
|
|
|
@@ -332,8 +369,8 @@ Run examples with: `node examples/basic-usage.js`
|
|
|
332
369
|
|
|
333
370
|
```bash
|
|
334
371
|
# Clone and install
|
|
335
|
-
git clone https://github.com/
|
|
336
|
-
cd
|
|
372
|
+
git clone https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced.git
|
|
373
|
+
cd ClickUp-MCP-Server---Enhanced
|
|
337
374
|
npm install
|
|
338
375
|
|
|
339
376
|
# Environment configuration
|
|
@@ -414,9 +451,9 @@ npm run test:coverage
|
|
|
414
451
|
```
|
|
415
452
|
|
|
416
453
|
### Post-release Verification
|
|
417
|
-
- Check npm package: https://www.npmjs.com/package/clickup-mcp-server
|
|
418
|
-
- Verify GitHub release: https://github.com/
|
|
419
|
-
- Test installation: `npm install clickup-mcp-server@latest`
|
|
454
|
+
- Check npm package: https://www.npmjs.com/package/@chykalophia/clickup-mcp-server
|
|
455
|
+
- Verify GitHub release: https://github.com/Chykalophia/ClickUp-MCP-Server---Enhanced/releases
|
|
456
|
+
- Test installation: `npm install @chykalophia/clickup-mcp-server@latest`
|
|
420
457
|
|
|
421
458
|
## 🔧 Technical Architecture
|
|
422
459
|
|
package/build/index-enhanced.js
CHANGED
|
@@ -26,7 +26,7 @@ class ClickUpServer {
|
|
|
26
26
|
constructor() {
|
|
27
27
|
this.server = new McpServer({
|
|
28
28
|
name: 'clickup-mcp-server',
|
|
29
|
-
version: '3.
|
|
29
|
+
version: '3.3.0', // Updated version for comprehensive ClickUp API coverage
|
|
30
30
|
});
|
|
31
31
|
// Handle process termination
|
|
32
32
|
process.on('SIGINT', async () => {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@chykalophia/clickup-mcp-server",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.3.0",
|
|
4
4
|
"description": "An intelligent Model Context Protocol server for ClickUp API integration with 170+ tools, AI-powered efficiency optimization, smart tool suggestions, and context-aware workflow recommendations",
|
|
5
5
|
"main": "build/index-enhanced.js",
|
|
6
6
|
"bin": {
|