@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 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/nsxdavid/clickup-mcp-server.git
180
- cd clickup-mcp-server
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
- ### Standard Version
234
+ ### 🚀 Quick Setup Configuration
235
+
236
+ #### NPM Package (Recommended) ⭐
196
237
  ```json
197
238
  {
198
239
  "mcpServers": {
199
240
  "clickup": {
200
- "command": "node",
201
- "args": ["/path/to/clickup-mcp-server/build/index-enhanced.js"],
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
- ### Enhanced Efficiency Version NEW!
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-efficiency-simple.js"],
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
- * Make sure to correct the path
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": "npx",
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
- * Replace `YOUR_API_TOKEN_HERE` with your API token
256
- * No installation or cloning is required with this method
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/nsxdavid/clickup-mcp-server.git
336
- cd clickup-mcp-server
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/nsxdavid/clickup-mcp-server/releases
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
 
@@ -36,7 +36,7 @@ class EfficiencyEnhancedClickUpServer {
36
36
  constructor() {
37
37
  this.server = new McpServer({
38
38
  name: 'clickup-mcp-server-efficiency',
39
- version: '3.2.0',
39
+ version: '3.3.0',
40
40
  });
41
41
  this.client = createClickUpClient();
42
42
  // Handle process termination
@@ -26,7 +26,7 @@ class ClickUpServer {
26
26
  constructor() {
27
27
  this.server = new McpServer({
28
28
  name: 'clickup-mcp-server',
29
- version: '3.0.0', // Updated version for comprehensive ClickUp API coverage
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.2.0",
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": {