@taazkareem/clickup-mcp-server 0.4.60 → 0.4.62
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 +10 -2
- package/build/config.js +10 -0
- package/build/index.js +9 -1356
- package/build/server.js +120 -0
- package/build/services/clickup/base.js +253 -0
- package/build/services/clickup/bulk.js +116 -0
- package/build/services/clickup/folder.js +133 -0
- package/build/services/clickup/index.js +43 -0
- package/build/services/clickup/initialization.js +28 -0
- package/build/services/clickup/list.js +188 -0
- package/build/services/clickup/task.js +492 -0
- package/build/services/clickup/types.js +4 -0
- package/build/services/clickup/workspace.js +314 -0
- package/build/services/shared.js +15 -0
- package/build/tools/folder.js +356 -0
- package/build/tools/index.js +11 -0
- package/build/tools/list.js +452 -0
- package/build/tools/task.js +1486 -0
- package/build/tools/utils.js +95 -0
- package/build/tools/workspace.js +132 -0
- package/package.json +3 -1
- package/build/services/clickup.js +0 -765
- package/build/types/clickup.js +0 -1
package/README.md
CHANGED
|
@@ -2,9 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
# MCP Server
|
|
4
4
|
|
|
5
|
+
> 🚧 **Status Update:** The code refactoring has been completed. Enhanced due date functionality now supports relative time expressions like "2 hours from now" with proper time display in ClickUp!
|
|
6
|
+
|
|
5
7
|
A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
|
|
6
8
|
|
|
7
|
-
## Quick Start
|
|
9
|
+
## npx Quick Start
|
|
8
10
|
|
|
9
11
|
Directions for use with Cursor Composer Agent:
|
|
10
12
|
|
|
@@ -22,8 +24,11 @@ npx -y @taazkareem/clickup-mcp-server \
|
|
|
22
24
|
5. Use Natural Language to interact with your ClickUp Workspace!
|
|
23
25
|
|
|
24
26
|
## Smithery
|
|
27
|
+
|
|
25
28
|
[](https://smithery.ai/server/@TaazKareem/clickup-mcp-server)
|
|
26
29
|
|
|
30
|
+
The server is also hosted on Smithery. There, you can preview the available tools or copy the commands to run on various clients.
|
|
31
|
+
|
|
27
32
|
## Features
|
|
28
33
|
|
|
29
34
|
- 🎯 **Task Management**
|
|
@@ -31,6 +36,7 @@ npx -y @taazkareem/clickup-mcp-server \
|
|
|
31
36
|
- Move and duplicate tasks between lists, spaces, and folders
|
|
32
37
|
- Create multiple tasks in bulk
|
|
33
38
|
- View and modify task details and properties
|
|
39
|
+
- Set due dates using natural language and relative time expressions
|
|
34
40
|
|
|
35
41
|
- 📂 **Workspace Organization**
|
|
36
42
|
- Complete workspace hierarchy (spaces, folders, lists)
|
|
@@ -38,7 +44,6 @@ npx -y @taazkareem/clickup-mcp-server \
|
|
|
38
44
|
- Full CRUD operations for workspace components
|
|
39
45
|
- Efficient path-based navigation
|
|
40
46
|
|
|
41
|
-
|
|
42
47
|
- 🔄 **Integration Features**
|
|
43
48
|
- Name or ID-based item lookup
|
|
44
49
|
- Case-insensitive name matching
|
|
@@ -59,10 +64,13 @@ npx -y @taazkareem/clickup-mcp-server \
|
|
|
59
64
|
| [create_task](docs/api-reference.md#task-management) | Create a task | `name`, (`listId`/`listName`) |
|
|
60
65
|
| [create_bulk_tasks](docs/api-reference.md#task-management) | Create multiple tasks | `tasks[]` |
|
|
61
66
|
| [update_task](docs/api-reference.md#task-management) | Modify task | `taskId`/`taskName` |
|
|
67
|
+
| [update_bulk_tasks](docs/api-reference.md#task-management) | Update multiple tasks | `tasks[]` with IDs or names |
|
|
62
68
|
| [get_tasks](docs/api-reference.md#task-retrieval) | Get tasks from list | `listId`/`listName` |
|
|
63
69
|
| [get_task](docs/api-reference.md#task-retrieval) | Get task details | `taskId`/`taskName` |
|
|
64
70
|
| [delete_task](docs/api-reference.md#task-management) | Remove task | `taskId`/`taskName` |
|
|
71
|
+
| [delete_bulk_tasks](docs/api-reference.md#task-management) | Remove multiple tasks | `tasks[]` with IDs or names |
|
|
65
72
|
| [move_task](docs/api-reference.md#task-management) | Move task | `taskId`/`taskName`, `listId`/`listName` |
|
|
73
|
+
| [move_bulk_tasks](docs/api-reference.md#task-management) | Move multiple tasks | `tasks[]` with IDs or names, target list |
|
|
66
74
|
| [duplicate_task](docs/api-reference.md#task-management) | Copy task | `taskId`/`taskName`, `listId`/`listName` |
|
|
67
75
|
| [create_list](docs/api-reference.md#list-management) | Create list in space | `name`, `spaceId`/`spaceName` |
|
|
68
76
|
| [create_folder](docs/api-reference.md#folder-management) | Create folder | `name`, `spaceId`/`spaceName` |
|
package/build/config.js
CHANGED
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Configuration handling for ClickUp API credentials
|
|
3
|
+
*
|
|
4
|
+
* The required environment variables (CLICKUP_API_KEY and CLICKUP_TEAM_ID) are passed
|
|
5
|
+
* securely to this file when running the hosted server at smithery.ai. Optionally,
|
|
6
|
+
* they can be parsed via command line arguments when running the server locally.
|
|
7
|
+
*/
|
|
8
|
+
// Parse any command line environment arguments
|
|
1
9
|
const args = process.argv.slice(2);
|
|
2
10
|
const envArgs = {};
|
|
3
11
|
for (let i = 0; i < args.length; i++) {
|
|
@@ -10,10 +18,12 @@ for (let i = 0; i < args.length; i++) {
|
|
|
10
18
|
i++;
|
|
11
19
|
}
|
|
12
20
|
}
|
|
21
|
+
// Load configuration from command line args or environment variables
|
|
13
22
|
const configuration = {
|
|
14
23
|
clickupApiKey: envArgs.clickupApiKey || process.env.CLICKUP_API_KEY || '',
|
|
15
24
|
clickupTeamId: envArgs.clickupTeamId || process.env.CLICKUP_TEAM_ID || '',
|
|
16
25
|
};
|
|
26
|
+
// Validate all required variables are present
|
|
17
27
|
const missingEnvVars = Object.entries(configuration)
|
|
18
28
|
.filter(([_, value]) => !value)
|
|
19
29
|
.map(([key]) => key);
|