@taazkareem/clickup-mcp-server 0.14.1 → 0.14.3
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 +250 -192
- package/build/auth/routes.js +1 -1
- package/build/config.js +1 -1
- package/build/index.js +1 -1
- package/build/license.js +1 -1
- package/build/logger.js +1 -1
- package/build/middleware/auth.js +1 -1
- package/build/middleware/security.js +1 -1
- package/build/personas.js +1 -1
- package/build/prompts.js +1 -1
- package/build/server.js +1 -1
- package/build/services/clickup/audit-logs.js +1 -1
- package/build/services/clickup/base.js +1 -1
- package/build/services/clickup/bulk.js +1 -1
- package/build/services/clickup/chat.js +1 -1
- package/build/services/clickup/custom-field.js +1 -1
- package/build/services/clickup/document.js +1 -1
- package/build/services/clickup/errors.js +1 -1
- package/build/services/clickup/folder.js +1 -1
- package/build/services/clickup/goal.js +1 -1
- package/build/services/clickup/guest.js +1 -1
- package/build/services/clickup/index.js +1 -1
- package/build/services/clickup/list.js +1 -1
- package/build/services/clickup/rate-limiter.js +1 -1
- package/build/services/clickup/sprint.js +1 -1
- package/build/services/clickup/tag.js +1 -1
- package/build/services/clickup/task/index.js +1 -1
- package/build/services/clickup/task/task-attachments.js +1 -1
- package/build/services/clickup/task/task-checklists.js +1 -1
- package/build/services/clickup/task/task-comments.js +1 -1
- package/build/services/clickup/task/task-core.js +1 -1
- package/build/services/clickup/task/task-relationships.js +1 -1
- package/build/services/clickup/task/task-search.js +1 -1
- package/build/services/clickup/task/task-service.js +1 -1
- package/build/services/clickup/task/task-tags.js +1 -1
- package/build/services/clickup/task-templates.js +1 -1
- package/build/services/clickup/time.js +1 -1
- package/build/services/clickup/types.js +1 -1
- package/build/services/clickup/user-group.js +1 -1
- package/build/services/clickup/view.js +1 -1
- package/build/services/clickup/webhook.js +1 -1
- package/build/services/clickup/workspace.js +1 -1
- package/build/services/oauth.js +1 -1
- package/build/services/shared.js +1 -1
- package/build/sse_server.js +1 -1
- package/build/tools/attachment.js +1 -1
- package/build/tools/audit-logs.js +1 -1
- package/build/tools/chat/handlers.js +1 -1
- package/build/tools/chat/index.js +1 -1
- package/build/tools/chat/utils.js +1 -1
- package/build/tools/custom-field.js +1 -1
- package/build/tools/documents.js +1 -1
- package/build/tools/feedback.js +1 -1
- package/build/tools/folder.js +1 -1
- package/build/tools/goal.js +1 -1
- package/build/tools/guest.js +1 -1
- package/build/tools/index.js +1 -1
- package/build/tools/list.js +1 -1
- package/build/tools/registry.js +1 -1
- package/build/tools/space.js +1 -1
- package/build/tools/sprint.js +1 -1
- package/build/tools/tag.js +1 -1
- package/build/tools/task/bulk-operations.js +1 -1
- package/build/tools/task/checklists.js +1 -1
- package/build/tools/task/handlers.js +1 -1
- package/build/tools/task/index.js +1 -1
- package/build/tools/task/main.js +1 -1
- package/build/tools/task/markdown-converter.js +1 -1
- package/build/tools/task/params.js +1 -1
- package/build/tools/task/relationships.js +1 -1
- package/build/tools/task/single-operations.js +1 -1
- package/build/tools/task/utilities.js +1 -1
- package/build/tools/task/workspace-operations.js +1 -1
- package/build/tools/task-templates.js +1 -1
- package/build/tools/time_entries.js +1 -1
- package/build/tools/user-group.js +1 -1
- package/build/tools/utils.js +1 -1
- package/build/tools/view.js +1 -1
- package/build/tools/webhook.js +1 -1
- package/build/tools/workspace.js +1 -1
- package/build/transport/mcp-handler.js +1 -1
- package/build/utils/cache.js +1 -1
- package/build/utils/color-processor.js +1 -1
- package/build/utils/concurrency-utils.js +1 -1
- package/build/utils/context-utils.js +1 -1
- package/build/utils/date-utils.js +1 -1
- package/build/utils/log-sanitizer.js +1 -1
- package/build/utils/member-utils.js +1 -1
- package/build/utils/request-utils.js +1 -1
- package/build/utils/resolver-utils.js +1 -1
- package/build/utils/sponsor-service.js +1 -1
- package/build/utils/token-utils.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
|
|
18
18
|
**Properly Connect ClickUp to AI Agents and Agentic Workflows**
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
_A high-performance Model Context Protocol (MCP) server for managing tasks, checklists, sprints, comments, tags, spaces, lists, folders, files, docs, chat, and time using natural language._
|
|
21
21
|
|
|
22
22
|
**⭐️ Proven Performance:** 460+ Stars (from previous public repo) & thousands of weekly NPM downloads.
|
|
23
23
|
The industry-standard ClickUp integration for AI.
|
|
@@ -26,15 +26,15 @@ The industry-standard ClickUp integration for AI.
|
|
|
26
26
|
|
|
27
27
|
## 📚 Table of Contents
|
|
28
28
|
|
|
29
|
-
| Links
|
|
30
|
-
|
|
|
29
|
+
| Links | Quick Start & Installation |
|
|
30
|
+
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
31
31
|
| • [Features](#features)<br>• [Premium Access](#premium-access)<br>• [Available Tools](#available-tools)<br>• [Adv. Config](#advanced-configuration)<br>• [FAQ](#faq)<br>• [Disclaimer](#disclaimer) | <table border="0" style="border: none; border-collapse: collapse; width: 575px;"> <tr style="border: none;"> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/openclaw-logo.svg" height="16" style="vertical-align: middle;"> OpenClaw](#openclaw-setup)</td> <td width="155" style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/cursor-white.svg" height="16" style="vertical-align: middle;"> Cursor](#cursor-setup)</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/visual-studio-code.svg" height="16" style="vertical-align: middle;"> VS Code](#vscode-setup)</td> <td width="140" style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="16" style="vertical-align: middle; border-radius: 4px;"> Roo Code](#roocode-setup)</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/claude.svg" height="16" style="vertical-align: middle;"> Claude](#claude-desktop-setup)</td> <td st yle="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://cdn.simpleicons.org/anthropic/D97757" height="16" style="vertical-align: middle;"> Claude Code](#claude-code-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="16" style="vertical-align: middle;"> n8n](#n8n-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="https://cdn.simpleicons.org/googlegemini/8E75C2" height="16" style="vertical-align: middle;"> Gemini CLI](#gemini-setup)</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/antigravity.svg" height="16" style="vertical-align: middle;"> Antigravity](#antigravity-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> Codex](#codex-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/openai-icon.svg" height="16" style="vertical-align: middle;"> ChatGPT](#chatgpt-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Augment](#augment-setup)</td> </tr> <tr style="border: none;"> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/augment-code.svg" height="16" style="vertical-align: middle;"> Auggie](#auggierun-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[<img src="./assets/logos/windsurf-white.svg" height="16" style="vertical-align: middle;"> Windsurf](#windsurf-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[Other](#other-setup)</td> <td style="border: none; vertical-align: middle; white-space: nowrap;">[➕ Add Agent](mailto:info@taazkareem.com?subject=Redirect%20URI%20Whitelist%20Request)</td> </tr> </table> |
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
35
35
|
## <a name="features"></a>✨ Features
|
|
36
36
|
|
|
37
|
-
**🔥 Multi-Account Support:** Manage multiple authorized workspaces seamlessly in a single session. [See setup](#multi-workspace-support)
|
|
37
|
+
**🔥 Multi-Account Support:** Manage multiple authorized workspaces seamlessly in a single session. [See setup](#multi-workspace-support)
|
|
38
38
|
|
|
39
39
|
<table border="0" style="width: 100%; border-collapse: collapse;">
|
|
40
40
|
<tr style="border: none;">
|
|
@@ -102,9 +102,10 @@ A license grants full, unrestricted access to all features across your agents⎯
|
|
|
102
102
|
|
|
103
103
|
<br>
|
|
104
104
|
|
|
105
|
-
| [**Monthly**](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW?utm_source=github&utm_medium=readme) $9/mo | [**Annual**](https://buy.polar.sh/polar_cl_3a8a3055T4CHIoVlSQPsNshOJLUwsM8AHAiIR3y9wTZ?utm_source=github&utm_medium=readme) $59/yr | [**Lifetime**](https://buy.polar.sh/polar_cl_4ha3uVyJTu4iPZJS1QbBYNTI1MKTvaXXCkZTb45vPPF?utm_source=github&utm_medium=readme)
|
|
106
|
-
|
|
|
107
|
-
| • Pay-as-you-go flexibility<br>• 3 device activations<br>• Cancel anytime
|
|
105
|
+
| [**Monthly**](https://buy.polar.sh/polar_cl_3xQojQLgzQXKCLzsxc49YfL6z8hzSBBqh9ivy1qZdwW?utm_source=github&utm_medium=readme) $9/mo | [**Annual**](https://buy.polar.sh/polar_cl_3a8a3055T4CHIoVlSQPsNshOJLUwsM8AHAiIR3y9wTZ?utm_source=github&utm_medium=readme) $59/yr | [**Lifetime**](https://buy.polar.sh/polar_cl_4ha3uVyJTu4iPZJS1QbBYNTI1MKTvaXXCkZTb45vPPF?utm_source=github&utm_medium=readme) <!--LIFETIME_HEADER-->$119<!--/LIFETIME_HEADER--> |
|
|
106
|
+
| :--------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
107
|
+
| • Pay-as-you-go flexibility<br>• 3 device activations<br>• Cancel anytime | • **Save 45%** ($4.92/mo)<br>• 3 device activations<br>• Priority support all year | • **Best Value** — One payment<br>• 3 device activations<br>• <!--LIFETIME_DETAIL-->Unlocked Forever<!--/LIFETIME_DETAIL--> |
|
|
108
|
+
|
|
108
109
|
<br>
|
|
109
110
|
|
|
110
111
|
<p align="center">
|
|
@@ -117,18 +118,18 @@ A license grants full, unrestricted access to all features across your agents⎯
|
|
|
117
118
|
|
|
118
119
|
</div>
|
|
119
120
|
|
|
120
|
-
|
|
121
121
|
---
|
|
122
122
|
|
|
123
123
|
## 🚀 Quick Start
|
|
124
124
|
|
|
125
125
|
### 1. Prerequisites
|
|
126
|
-
|
|
127
|
-
|
|
126
|
+
|
|
127
|
+
- **License Key:** See above
|
|
128
|
+
- **ClickUp API Key** (Optional - not needed for Remote MCP)
|
|
128
129
|
- Log into ClickUp and go to [ClickUp Settings → Apps](https://app.clickup.com/settings/apps).
|
|
129
130
|
- Click **Generate** under "API Token" (or copy your existing one).
|
|
130
131
|
|
|
131
|
-
|
|
132
|
+
- **ClickUp Team ID** (Optional - not needed for Remote MCP)
|
|
132
133
|
- Open ClickUp in your browser.
|
|
133
134
|
- Look at the URL: `https://app.clickup.com/1234567/v/li/987654321`.
|
|
134
135
|
- The first number (`1234567`) directly after `clickup.com/` is your **Team ID** (Workspace ID).
|
|
@@ -136,12 +137,14 @@ A license grants full, unrestricted access to all features across your agents⎯
|
|
|
136
137
|
### 2. Choose your MCP Host & Transport
|
|
137
138
|
|
|
138
139
|
<a name="openclaw-setup"></a>
|
|
140
|
+
|
|
139
141
|
<details>
|
|
140
142
|
<summary> <img src="./assets/logos/openclaw-logo.svg" height="22" align="center"> <strong>OpenClaw (via mcporter) </strong> <sub> FEATURED</sub></summary>
|
|
141
143
|
|
|
142
144
|
**1. Enable** mcporter in `~/.openclaw/openclaw.json`:
|
|
145
|
+
|
|
143
146
|
```json
|
|
144
|
-
{"skills": {"allowBundled": ["mcporter"]}}
|
|
147
|
+
{ "skills": { "allowBundled": ["mcporter"] } }
|
|
145
148
|
```
|
|
146
149
|
|
|
147
150
|
**2. Configure & Auth**
|
|
@@ -166,7 +169,7 @@ mcporter --config <agent-workspace>/config/mcporter.json config add ClickUp-Audi
|
|
|
166
169
|
--header "X-ClickUp-Key=your-api-key" \
|
|
167
170
|
--header "X-ClickUp-Team-Id=your-team-id"
|
|
168
171
|
|
|
169
|
-
# Define a Task Worker persona (Daily CRUD) in the same or different workspace
|
|
172
|
+
# Define a Task Worker persona (Daily CRUD) in the same or different workspace
|
|
170
173
|
mcporter --config <agent-workspace-2>/config/mcporter.json config add ClickUp-Worker https://clickup-mcp.taazkareem.com/mcp \
|
|
171
174
|
--header "X-Persona=task_worker" \
|
|
172
175
|
--header "X-License-Key=your-license-key" \
|
|
@@ -181,7 +184,6 @@ mcporter list ClickUp-Worker --schema
|
|
|
181
184
|
mcporter call ClickUp-Worker.create_task listId="123456789" name="New Task"
|
|
182
185
|
```
|
|
183
186
|
|
|
184
|
-
>
|
|
185
187
|
> **Isolation**: You can add X-Enabled-Tools or X-Disabled-Tools to mix and match tools and personas, or perhaps enable just a single tool. You can assign different ClickUp API Keys, Team IDs, or even different License Keys to each config/persona. Since the agent only reads the tool definitions and not the sensitive headers directly, this is the most secure way to handle multi-agent ClickUp configurations.
|
|
186
188
|
|
|
187
189
|
To see all available personas and what they do, see the [Advanced Configuration](#advanced-configuration) section below.
|
|
@@ -189,12 +191,14 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
189
191
|
</details>
|
|
190
192
|
|
|
191
193
|
<a name="cursor-setup"></a>
|
|
194
|
+
|
|
192
195
|
<details>
|
|
193
196
|
<summary> <img src="./assets/logos/cursor-white.svg" height="22" align="center"> <strong>Cursor</strong></summary>
|
|
194
197
|
|
|
195
198
|
**Configuration Path:** `<project-root>/.cursor/mcp.json`
|
|
196
199
|
|
|
197
200
|
**Option A: Remote / Streamable HTTP (Easiest)**
|
|
201
|
+
|
|
198
202
|
```json
|
|
199
203
|
{
|
|
200
204
|
"mcpServers": {
|
|
@@ -209,6 +213,7 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
209
213
|
```
|
|
210
214
|
|
|
211
215
|
**Option B: Local / STDIO**
|
|
216
|
+
|
|
212
217
|
```json
|
|
213
218
|
{
|
|
214
219
|
"mcpServers": {
|
|
@@ -224,17 +229,21 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
224
229
|
}
|
|
225
230
|
}
|
|
226
231
|
```
|
|
232
|
+
|
|
227
233
|
</details>
|
|
228
234
|
|
|
229
235
|
<a name="vscode-setup"></a>
|
|
236
|
+
|
|
230
237
|
<details>
|
|
231
|
-
<summary> <img src="./assets/logos/visual-studio-code.svg" height="22" align="center"> <strong>VS Code</strong></summary>
|
|
238
|
+
<summary> <img src="./assets/logos/visual-studio-code.svg" height="22" align="center"> <strong>VS Code</strong></summary>
|
|
232
239
|
|
|
233
240
|
**Configuration Paths:**
|
|
241
|
+
|
|
234
242
|
- **Global:** `~/Library/Application Support/Code/User/mcp.json`
|
|
235
243
|
- **Local:** `<project-root>/.vscode/mcp.json`
|
|
236
244
|
|
|
237
245
|
**Option A: Remote / Streamable HTTP (Easiest)**
|
|
246
|
+
|
|
238
247
|
```json
|
|
239
248
|
{
|
|
240
249
|
"mcpServers": {
|
|
@@ -249,6 +258,7 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
249
258
|
```
|
|
250
259
|
|
|
251
260
|
**Option B: Local / STDIO**
|
|
261
|
+
|
|
252
262
|
```json
|
|
253
263
|
{
|
|
254
264
|
"mcpServers": {
|
|
@@ -264,15 +274,18 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
264
274
|
}
|
|
265
275
|
}
|
|
266
276
|
```
|
|
277
|
+
|
|
267
278
|
</details>
|
|
268
279
|
|
|
269
280
|
<a name="roocode-setup"></a>
|
|
281
|
+
|
|
270
282
|
<details>
|
|
271
|
-
<summary> <img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="22" align="center" style="border-radius: 4px;"> <strong>Roo Code</strong></summary>
|
|
283
|
+
<summary> <img src="https://avatars.githubusercontent.com/u/211522643?s=200&v=4" height="22" align="center" style="border-radius: 4px;"> <strong>Roo Code</strong></summary>
|
|
272
284
|
|
|
273
285
|
**Configuration Path:** `<project-root>/.roo/mcp.json`
|
|
274
286
|
|
|
275
287
|
**Option A: Remote / Streamable HTTP (Easiest)**
|
|
288
|
+
|
|
276
289
|
```json
|
|
277
290
|
{
|
|
278
291
|
"mcpServers": {
|
|
@@ -287,6 +300,7 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
287
300
|
```
|
|
288
301
|
|
|
289
302
|
**Option B: Local / STDIO**
|
|
303
|
+
|
|
290
304
|
```json
|
|
291
305
|
{
|
|
292
306
|
"mcpServers": {
|
|
@@ -302,47 +316,58 @@ To see all available personas and what they do, see the [Advanced Configuration]
|
|
|
302
316
|
}
|
|
303
317
|
}
|
|
304
318
|
```
|
|
319
|
+
|
|
305
320
|
</details>
|
|
306
321
|
|
|
307
322
|
<a name="claude-desktop-setup"></a>
|
|
323
|
+
|
|
308
324
|
<details>
|
|
309
|
-
<summary> <img src="./assets/logos/claude.svg" height="22" align="center"> <strong>Claude Desktop</strong></summary>
|
|
325
|
+
<summary> <img src="./assets/logos/claude.svg" height="22" align="center"> <strong>Claude Desktop</strong></summary>
|
|
310
326
|
|
|
311
327
|
**Configuration Path:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
312
328
|
|
|
313
329
|
**Remote Setup (Requires `mcp-remote` adapter):**
|
|
330
|
+
|
|
314
331
|
```json
|
|
315
332
|
{
|
|
316
333
|
"mcpServers": {
|
|
317
334
|
"ClickUp": {
|
|
318
335
|
"command": "npx",
|
|
319
336
|
"args": [
|
|
320
|
-
"-y",
|
|
337
|
+
"-y",
|
|
338
|
+
"mcp-remote",
|
|
321
339
|
"https://clickup-mcp.taazkareem.com/mcp",
|
|
322
|
-
"--header",
|
|
340
|
+
"--header",
|
|
341
|
+
"X-License-Key: your-license-key"
|
|
323
342
|
]
|
|
324
343
|
}
|
|
325
344
|
}
|
|
326
345
|
}
|
|
327
346
|
```
|
|
347
|
+
|
|
328
348
|
</details>
|
|
329
349
|
|
|
330
350
|
<a name="claude-code-setup"></a>
|
|
351
|
+
|
|
331
352
|
<details>
|
|
332
|
-
<summary> <img src="https://cdn.simpleicons.org/anthropic/D97757" height="22" align="center"> <strong>Claude Code (CLI)</strong></summary>
|
|
353
|
+
<summary> <img src="https://cdn.simpleicons.org/anthropic/D97757" height="22" align="center"> <strong>Claude Code (CLI)</strong></summary>
|
|
333
354
|
|
|
334
355
|
Run this command in your terminal:
|
|
356
|
+
|
|
335
357
|
```bash
|
|
336
358
|
claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
|
|
337
359
|
--header "X-License-Key: your-license-key"
|
|
338
360
|
```
|
|
361
|
+
|
|
339
362
|
</details>
|
|
340
363
|
|
|
341
364
|
<a name="n8n-setup"></a>
|
|
365
|
+
|
|
342
366
|
<details>
|
|
343
|
-
<summary> <img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="22" align="center"> <strong>n8n</strong></summary>
|
|
367
|
+
<summary> <img src="https://cdn.simpleicons.org/n8n/FF6D5A" height="22" align="center"> <strong>n8n</strong></summary>
|
|
344
368
|
|
|
345
369
|
**Option A: Remote / Streamable HTTP (Recommended)**
|
|
370
|
+
|
|
346
371
|
1. In n8n, add an **"MCP Client"** node.
|
|
347
372
|
2. Set Connection Type to `Streamable HTTP`.
|
|
348
373
|
3. Auth Type: `Multiple Headers Auth`.
|
|
@@ -351,17 +376,22 @@ claude mcp add --transport http ClickUp https://clickup-mcp.taazkareem.com/mcp \
|
|
|
351
376
|
|
|
352
377
|
**Option B: Self-Hosted Docker**
|
|
353
378
|
Run the container:
|
|
379
|
+
|
|
354
380
|
```bash
|
|
355
381
|
docker run -d -p 3231:3231 ghcr.io/taazkareem/clickup-mcp-server:latest
|
|
356
382
|
```
|
|
383
|
+
|
|
357
384
|
In n8n, use URL: `http://host.docker.internal:3231/mcp`
|
|
385
|
+
|
|
358
386
|
</details>
|
|
359
387
|
|
|
360
388
|
<a name="gemini-setup"></a>
|
|
389
|
+
|
|
361
390
|
<details>
|
|
362
|
-
<summary> <img src="https://cdn.simpleicons.org/googlegemini/8E75C2" height="22" align="center"> <strong>Gemini CLI</strong></summary>
|
|
391
|
+
<summary> <img src="https://cdn.simpleicons.org/googlegemini/8E75C2" height="22" align="center"> <strong>Gemini CLI</strong></summary>
|
|
363
392
|
|
|
364
393
|
**Configuration Path:** `~/.gemini/settings.json`
|
|
394
|
+
|
|
365
395
|
```json
|
|
366
396
|
{
|
|
367
397
|
"mcpServers": {
|
|
@@ -372,13 +402,16 @@ In n8n, use URL: `http://host.docker.internal:3231/mcp`
|
|
|
372
402
|
}
|
|
373
403
|
}
|
|
374
404
|
```
|
|
405
|
+
|
|
375
406
|
</details>
|
|
376
407
|
|
|
377
408
|
<a name="antigravity-setup"></a>
|
|
409
|
+
|
|
378
410
|
<details>
|
|
379
|
-
<summary> <img src="./assets/logos/antigravity.svg" height="22" align="center"> <strong>Antigravity</strong></summary>
|
|
411
|
+
<summary> <img src="./assets/logos/antigravity.svg" height="22" align="center"> <strong>Antigravity</strong></summary>
|
|
380
412
|
|
|
381
413
|
**Configuration Path:** `~/.gemini/antigravity/mcp_config.json`
|
|
414
|
+
|
|
382
415
|
```json
|
|
383
416
|
{
|
|
384
417
|
"mcpServers": {
|
|
@@ -389,19 +422,23 @@ In n8n, use URL: `http://host.docker.internal:3231/mcp`
|
|
|
389
422
|
}
|
|
390
423
|
}
|
|
391
424
|
```
|
|
425
|
+
|
|
392
426
|
</details>
|
|
393
427
|
|
|
394
428
|
<a name="codex-setup"></a>
|
|
429
|
+
|
|
395
430
|
<details>
|
|
396
|
-
<summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>Codex (CLI, Desktop, IDE)</strong></summary>
|
|
431
|
+
<summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>Codex (CLI, Desktop, IDE)</strong></summary>
|
|
397
432
|
|
|
398
433
|
Codex clients (CLI, Desktop App, and VS Code extension) share a single source of truth for configuration.
|
|
399
434
|
|
|
400
435
|
**Configuration Paths:**
|
|
436
|
+
|
|
401
437
|
- **Global:** `~/.codex/config.toml`
|
|
402
438
|
- **Local:** `<project-root>/.codex/config.toml`
|
|
403
439
|
|
|
404
440
|
**Option A: Remote / Streamable HTTP (Easiest)**
|
|
441
|
+
|
|
405
442
|
```toml
|
|
406
443
|
[mcp_servers.ClickUp]
|
|
407
444
|
url = "https://clickup-mcp.taazkareem.com/mcp"
|
|
@@ -409,6 +446,7 @@ http_headers = { "X-License-Key" = "your-license-key" }
|
|
|
409
446
|
```
|
|
410
447
|
|
|
411
448
|
**Option B: Local / STDIO**
|
|
449
|
+
|
|
412
450
|
```toml
|
|
413
451
|
[mcp_servers.ClickUp]
|
|
414
452
|
command = "npx"
|
|
@@ -421,16 +459,18 @@ env = {
|
|
|
421
459
|
```
|
|
422
460
|
|
|
423
461
|
**Quick Tips:**
|
|
462
|
+
|
|
424
463
|
- **Codex CLI:** Run `codex mcp list` to verify. Use `codex mcp add ...` as a CLI alternative to editing the file.
|
|
425
464
|
- **VS Code Extension:** Click **⚙ → MCP settings → Open config.toml**.
|
|
426
465
|
- **Desktop App:** Go to **Settings → Integrations & MCP**.
|
|
427
466
|
</details>
|
|
428
467
|
|
|
429
468
|
<a name="chatgpt-setup"></a>
|
|
469
|
+
|
|
430
470
|
<details>
|
|
431
|
-
<summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>ChatGPT (Developer Mode)</strong></summary>
|
|
471
|
+
<summary> <img src="./assets/logos/openai-icon.svg" height="22" align="center"> <strong>ChatGPT (Developer Mode)</strong></summary>
|
|
432
472
|
|
|
433
|
-
|
|
473
|
+
_Note: Requires a Business, Enterprise, or Edu workspace with Developer Mode enabled._
|
|
434
474
|
|
|
435
475
|
1. **Enable Developer Mode:** Ask your workspace admin to enable this under **Workspace Settings → Permissions & Roles → Connected Data**.
|
|
436
476
|
2. **Connect MCP:** Go to **Settings → Connectors** and toggle **Developer Mode** on.
|
|
@@ -444,10 +484,12 @@ env = {
|
|
|
444
484
|
</details>
|
|
445
485
|
|
|
446
486
|
<a name="augment-setup"></a>
|
|
487
|
+
|
|
447
488
|
<details>
|
|
448
|
-
<summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Augment Code</strong></summary>
|
|
489
|
+
<summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Augment Code</strong></summary>
|
|
449
490
|
|
|
450
491
|
**Configuration Path:** `<project-root>/.augment/settings.json`
|
|
492
|
+
|
|
451
493
|
```json
|
|
452
494
|
{
|
|
453
495
|
"mcpServers": {
|
|
@@ -460,26 +502,32 @@ env = {
|
|
|
460
502
|
}
|
|
461
503
|
}
|
|
462
504
|
```
|
|
505
|
+
|
|
463
506
|
</details>
|
|
464
507
|
|
|
465
508
|
<a name="auggierun-setup"></a>
|
|
509
|
+
|
|
466
510
|
<details>
|
|
467
|
-
<summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Auggie CLI</strong></summary>
|
|
511
|
+
<summary> <img src="./assets/logos/augment-code.svg" height="22" align="center"> <strong>Auggie CLI</strong></summary>
|
|
468
512
|
|
|
469
513
|
Run this command in your terminal:
|
|
514
|
+
|
|
470
515
|
```bash
|
|
471
516
|
auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
|
|
472
517
|
--header "X-License-Key: your-license-key"
|
|
473
518
|
```
|
|
519
|
+
|
|
474
520
|
</details>
|
|
475
521
|
|
|
476
522
|
<a name="windsurf-setup"></a>
|
|
523
|
+
|
|
477
524
|
<details>
|
|
478
525
|
<summary> <img src="./assets/logos/windsurf-white.svg" height="22" align="center"> <strong>Windsurf</strong></summary>
|
|
479
526
|
|
|
480
527
|
**Configuration Path:** `<project-root>/.codeium/windsurf/mcp_config.json`
|
|
481
528
|
|
|
482
529
|
**Option A: Remote / Streamable HTTP (Easiest)**
|
|
530
|
+
|
|
483
531
|
```json
|
|
484
532
|
{
|
|
485
533
|
"mcpServers": {
|
|
@@ -494,6 +542,7 @@ auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
|
|
|
494
542
|
```
|
|
495
543
|
|
|
496
544
|
**Option B: Local / STDIO**
|
|
545
|
+
|
|
497
546
|
```json
|
|
498
547
|
{
|
|
499
548
|
"mcpServers": {
|
|
@@ -509,15 +558,18 @@ auggie mcp add ClickUp --url https://clickup-mcp.taazkareem.com/mcp \
|
|
|
509
558
|
}
|
|
510
559
|
}
|
|
511
560
|
```
|
|
561
|
+
|
|
512
562
|
</details>
|
|
513
563
|
|
|
514
564
|
<a name="other-setup"></a>
|
|
565
|
+
|
|
515
566
|
<details>
|
|
516
|
-
<summary> <strong>Other (Custom Agents, etc.)</strong></summary>
|
|
567
|
+
<summary> <strong>Other (Custom Agents, etc.)</strong></summary>
|
|
517
568
|
|
|
518
569
|
For most MCP-compliant hosts (e.g. Smithery, MCP Inspector, custom GUIs):
|
|
519
|
-
|
|
520
|
-
|
|
570
|
+
|
|
571
|
+
- **Server URL:** `https://clickup-mcp.taazkareem.com/mcp`
|
|
572
|
+
- **Auth Header:** `X-License-Key: your-license-key` (Required for HTTP/SSE connections)
|
|
521
573
|
|
|
522
574
|
---
|
|
523
575
|
|
|
@@ -525,6 +577,7 @@ For most MCP-compliant hosts (e.g. Smithery, MCP Inspector, custom GUIs):
|
|
|
525
577
|
For developers building custom agents.
|
|
526
578
|
|
|
527
579
|
**Python SDK:**
|
|
580
|
+
|
|
528
581
|
```python
|
|
529
582
|
from agents import Agent, Runner
|
|
530
583
|
from agents.mcp import MCPServerStreamableHttp
|
|
@@ -543,9 +596,11 @@ async with MCPServerStreamableHttp(
|
|
|
543
596
|
)
|
|
544
597
|
result = await Runner.run(agent, "List my workspaces.")
|
|
545
598
|
```
|
|
599
|
+
|
|
546
600
|
</details>
|
|
547
601
|
|
|
548
602
|
### 3. Restart
|
|
603
|
+
|
|
549
604
|
Restart your MCP Host (e.g., Cursor IDE). The server will validate your License Key and start automatically.
|
|
550
605
|
|
|
551
606
|
---
|
|
@@ -555,160 +610,161 @@ Restart your MCP Host (e.g., Cursor IDE). The server will validate your License
|
|
|
555
610
|
<details>
|
|
556
611
|
<summary><strong>👇 Click to view all 150 available tools</strong></summary>
|
|
557
612
|
|
|
558
|
-
| Category
|
|
559
|
-
|
|
|
560
|
-
| **Workspace**
|
|
561
|
-
|
|
|
562
|
-
|
|
|
563
|
-
|
|
|
564
|
-
| **Tasks**
|
|
565
|
-
|
|
|
566
|
-
|
|
|
567
|
-
|
|
|
568
|
-
|
|
|
569
|
-
|
|
|
570
|
-
|
|
|
571
|
-
|
|
|
572
|
-
|
|
|
573
|
-
|
|
|
574
|
-
|
|
|
575
|
-
|
|
|
576
|
-
|
|
|
577
|
-
|
|
|
578
|
-
|
|
|
579
|
-
|
|
|
580
|
-
|
|
|
581
|
-
|
|
|
582
|
-
|
|
|
583
|
-
|
|
|
584
|
-
|
|
|
585
|
-
|
|
|
586
|
-
|
|
|
587
|
-
|
|
|
588
|
-
|
|
|
589
|
-
|
|
|
590
|
-
|
|
|
591
|
-
| **Attachments**
|
|
592
|
-
|
|
|
593
|
-
|
|
|
594
|
-
| **Checklists**
|
|
595
|
-
|
|
|
596
|
-
|
|
|
597
|
-
|
|
|
598
|
-
|
|
|
599
|
-
|
|
|
600
|
-
| **Sprints**
|
|
601
|
-
|
|
|
602
|
-
|
|
|
603
|
-
| **Lists**
|
|
604
|
-
|
|
|
605
|
-
|
|
|
606
|
-
|
|
|
607
|
-
|
|
|
608
|
-
|
|
|
609
|
-
|
|
|
610
|
-
|
|
|
611
|
-
| **Custom Fields**
|
|
612
|
-
|
|
|
613
|
-
|
|
|
614
|
-
|
|
|
615
|
-
| **Spaces**
|
|
616
|
-
|
|
|
617
|
-
|
|
|
618
|
-
|
|
|
619
|
-
|
|
|
620
|
-
|
|
|
621
|
-
| **Goals**
|
|
622
|
-
|
|
|
623
|
-
|
|
|
624
|
-
|
|
|
625
|
-
|
|
|
626
|
-
|
|
|
627
|
-
|
|
|
628
|
-
|
|
|
629
|
-
| **Views**
|
|
630
|
-
|
|
|
631
|
-
|
|
|
632
|
-
|
|
|
633
|
-
|
|
|
634
|
-
|
|
|
635
|
-
| **Folders**
|
|
636
|
-
|
|
|
637
|
-
|
|
|
638
|
-
|
|
|
639
|
-
|
|
|
640
|
-
|
|
|
641
|
-
|
|
|
642
|
-
|
|
|
643
|
-
| **Tags**
|
|
644
|
-
|
|
|
645
|
-
|
|
|
646
|
-
|
|
|
647
|
-
|
|
|
648
|
-
|
|
|
649
|
-
| **Time Tracking**
|
|
650
|
-
|
|
|
651
|
-
|
|
|
652
|
-
|
|
|
653
|
-
|
|
|
654
|
-
|
|
|
655
|
-
|
|
|
656
|
-
|
|
|
657
|
-
|
|
|
658
|
-
|
|
|
659
|
-
|
|
|
660
|
-
|
|
|
661
|
-
|
|
|
662
|
-
| **Docs**
|
|
663
|
-
|
|
|
664
|
-
|
|
|
665
|
-
|
|
|
666
|
-
|
|
|
667
|
-
|
|
|
668
|
-
|
|
|
669
|
-
|
|
|
670
|
-
| **Chat**
|
|
671
|
-
|
|
|
672
|
-
|
|
|
673
|
-
|
|
|
674
|
-
|
|
|
675
|
-
|
|
|
676
|
-
|
|
|
677
|
-
|
|
|
678
|
-
|
|
|
679
|
-
|
|
|
680
|
-
|
|
|
681
|
-
|
|
|
682
|
-
|
|
|
683
|
-
|
|
|
684
|
-
|
|
|
685
|
-
|
|
|
686
|
-
|
|
|
687
|
-
|
|
|
688
|
-
|
|
|
689
|
-
| **Webhooks**
|
|
690
|
-
|
|
|
691
|
-
|
|
|
692
|
-
|
|
|
693
|
-
| **User Groups**
|
|
694
|
-
|
|
|
695
|
-
|
|
|
696
|
-
|
|
|
697
|
-
| **Guests**
|
|
698
|
-
|
|
|
699
|
-
|
|
|
700
|
-
|
|
|
701
|
-
|
|
|
702
|
-
|
|
|
703
|
-
|
|
|
704
|
-
|
|
|
705
|
-
|
|
|
706
|
-
|
|
|
707
|
-
| **Task Templates** | `get_task_templates`
|
|
708
|
-
|
|
|
709
|
-
| **Feedback**
|
|
710
|
-
|
|
711
|
-
|
|
613
|
+
| Category | Tool | Description |
|
|
614
|
+
| :----------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------ |
|
|
615
|
+
| **Workspace** | `get_workspace` | Get workspace structure and metadata (hierarchy, members, plan, seats, shared items, custom task types) |
|
|
616
|
+
| | `get_workspace_seats` | Get member and guest seat utilization (used, total, available) |
|
|
617
|
+
| | `get_workspace_plan` | Get plan details for the workspace (plan_name, plan_id) |
|
|
618
|
+
| | `get_audit_logs` | Retrieve workspace audit logs (Enterprise only) |
|
|
619
|
+
| **Tasks** | `create_task` | Create a task |
|
|
620
|
+
| | `get_task` | Get single task details |
|
|
621
|
+
| | `update_task` | Modify task properties |
|
|
622
|
+
| | `move_task` | Move task to new list |
|
|
623
|
+
| | `duplicate_task` | Copy task |
|
|
624
|
+
| | `delete_task` | Remove task |
|
|
625
|
+
| | `add_task_to_list` | Associate task with additional list (TIML) |
|
|
626
|
+
| | `remove_task_from_list` | Remove task list association (TIML) |
|
|
627
|
+
| | `create_bulk_tasks` | Create multiple tasks |
|
|
628
|
+
| | `update_bulk_tasks` | Update multiple tasks |
|
|
629
|
+
| | `move_bulk_tasks` | Move multiple tasks |
|
|
630
|
+
| | `delete_bulk_tasks` | Delete multiple tasks |
|
|
631
|
+
| | `get_workspace_tasks` | Search tasks with Deep Search filtering |
|
|
632
|
+
| | `get_comments` | Get comments on a task, list, or view |
|
|
633
|
+
| | `create_comment` | Create a comment on a task, list, or view |
|
|
634
|
+
| | `update_comment` | Edit or resolve a comment |
|
|
635
|
+
| | `delete_comment` | Delete a comment |
|
|
636
|
+
| | `get_comment_replies` | Get threaded replies for a comment |
|
|
637
|
+
| | `create_comment_reply` | Reply to a comment in a thread |
|
|
638
|
+
| | `add_comment_reaction` | Add an emoji reaction to a comment |
|
|
639
|
+
| | `remove_comment_reaction` | Remove an emoji reaction from a comment |
|
|
640
|
+
| | `get_comment_subtypes` | Get post subtype IDs for the workspace |
|
|
641
|
+
| | `add_task_link` | Link two tasks together |
|
|
642
|
+
| | `get_task_links` | Get task links |
|
|
643
|
+
| | `delete_task_link` | Remove a task link |
|
|
644
|
+
| | `add_task_dependency` | Set a blocking dependency between tasks |
|
|
645
|
+
| | `delete_task_dependency` | Remove a blocking dependency between tasks |
|
|
646
|
+
| **Attachments** | `list_attachments` | List attachments for a task or file custom field (v3) |
|
|
647
|
+
| | `get_attachment` | Get a specific attachment by ID or name (v3) |
|
|
648
|
+
| | `upload_attachment` | Upload a file to a task or file custom field (v3) |
|
|
649
|
+
| **Checklists** | `create_checklist` | Add a checklist to a task |
|
|
650
|
+
| | `edit_checklist` | Rename or reorder a checklist |
|
|
651
|
+
| | `delete_checklist` | Delete a checklist and all its items |
|
|
652
|
+
| | `create_checklist_item` | Add an item to a checklist |
|
|
653
|
+
| | `edit_checklist_item` | Update a checklist item (name, resolved, assignee, nesting) |
|
|
654
|
+
| | `delete_checklist_item` | Remove an item from a checklist |
|
|
655
|
+
| **Sprints** | `get_active_sprint` | Auto-detect the currently active sprint; returns tasks if exactly one found |
|
|
656
|
+
| | `list_sprints` | List all sprints in a folder |
|
|
657
|
+
| | `get_sprint_tasks` | Get tasks for a specific sprint list |
|
|
658
|
+
| **Lists** | `list_lists` | Retrieve lists in a space (folderless) or in a folder |
|
|
659
|
+
| | `get_list` | Get list details |
|
|
660
|
+
| | `create_list` | Create a list in a space or folder |
|
|
661
|
+
| | `create_list_from_template` | Create a new list from a template |
|
|
662
|
+
| | `update_list` | Update list properties |
|
|
663
|
+
| | `delete_list` | Delete a list |
|
|
664
|
+
| | `move_list` | Move a list to a different space or folder (high-integrity) |
|
|
665
|
+
| | `set_list_permissions` | Update list privacy and sharing (ACLs) |
|
|
666
|
+
| **Custom Fields** | `list_custom_fields` | List field definitions for a list, folder, or space |
|
|
667
|
+
| | `create_custom_field` | Add a new field definition to a list |
|
|
668
|
+
| | `set_custom_field_value` | Set a field value on a task |
|
|
669
|
+
| | `remove_custom_field_value` | Clear a field value from a task |
|
|
670
|
+
| **Spaces** | `list_spaces` | List all spaces in the workspace |
|
|
671
|
+
| | `get_space` | Get space details |
|
|
672
|
+
| | `create_space` | Create a new space |
|
|
673
|
+
| | `update_space` | Update space properties |
|
|
674
|
+
| | `delete_space` | Delete a space |
|
|
675
|
+
| | `set_space_permissions` | Update space privacy and sharing (ACLs) |
|
|
676
|
+
| **Goals** | `list_goals` | List all goals in the workspace |
|
|
677
|
+
| | `get_goal` | Get a goal with its key results |
|
|
678
|
+
| | `create_goal` | Create a new goal |
|
|
679
|
+
| | `update_goal` | Update a goal's properties |
|
|
680
|
+
| | `delete_goal` | Delete a goal |
|
|
681
|
+
| | `create_key_result` | Add a key result to a goal |
|
|
682
|
+
| | `update_key_result` | Update a key result |
|
|
683
|
+
| | `delete_key_result` | Delete a key result |
|
|
684
|
+
| **Views** | `list_views` | List views for a space, folder, list, or workspace |
|
|
685
|
+
| | `get_view` | Get a single view |
|
|
686
|
+
| | `create_view` | Create a new view |
|
|
687
|
+
| | `update_view` | Update a view |
|
|
688
|
+
| | `delete_view` | Delete a view |
|
|
689
|
+
| | `get_view_tasks` | Get tasks in a view |
|
|
690
|
+
| **Folders** | `list_folders` | List all folders in a space |
|
|
691
|
+
| | `get_folder` | Get folder details and its contained lists |
|
|
692
|
+
| | `create_folder` | Create a folder in a space |
|
|
693
|
+
| | `update_folder` | Update folder properties |
|
|
694
|
+
| | `delete_folder` | Delete a folder |
|
|
695
|
+
| | `move_folder` | Move a folder to a different space (high-integrity) |
|
|
696
|
+
| | `set_folder_permissions` | Update folder privacy and sharing (ACLs) |
|
|
697
|
+
| | `create_folder_from_template` | Create a folder from a template in a space |
|
|
698
|
+
| **Tags** | `list_space_tags` | List all tags in a space |
|
|
699
|
+
| | `create_space_tag` | Create a new space tag |
|
|
700
|
+
| | `update_space_tag` | Update a space tag's name or colors |
|
|
701
|
+
| | `delete_space_tag` | Delete a tag from a space |
|
|
702
|
+
| | `add_tag_to_task` | Add tag to task |
|
|
703
|
+
| | `remove_tag_from_task` | Remove tag from task |
|
|
704
|
+
| **Time Tracking** | `get_time_entries` | Fetch historical time entries |
|
|
705
|
+
| | `get_current_time_entry` | Get currently running timer |
|
|
706
|
+
| | `start_time_entry` | Start tracking time for a task |
|
|
707
|
+
| | `stop_time_entry` | Stop the active timer |
|
|
708
|
+
| | `add_time_entry` | Manually log a time entry |
|
|
709
|
+
| | `update_time_entry` | Modify an existing time entry |
|
|
710
|
+
| | `delete_time_entry` | Delete a time entry |
|
|
711
|
+
| | `get_time_entry_tags` | Fetch all workspace time entry tags |
|
|
712
|
+
| | `add_time_entry_tags` | Add a tag to a time entry |
|
|
713
|
+
| | `update_time_entry_tags` | Rename a workspace time entry tag globally |
|
|
714
|
+
| | `delete_time_entry_tags` | Remove a tag from a time entry |
|
|
715
|
+
| | `get_time_entry_history` | View edit history of a time entry |
|
|
716
|
+
| | `get_time_in_status` | Get time-in-status for multiple tasks |
|
|
717
|
+
| **Docs** | `list_documents` | List documents in a workspace or container |
|
|
718
|
+
| | `get_document` | Get document metadata |
|
|
719
|
+
| | `create_document` | Create a new standalone document |
|
|
720
|
+
| | `list_document_pages` | List all pages in a document |
|
|
721
|
+
| | `get_document_page` | Get content for a single page |
|
|
722
|
+
| | `get_document_pages` | Get content for multiple pages in one call |
|
|
723
|
+
| | `create_document_page` | Add a new page to a document |
|
|
724
|
+
| | `update_document_page` | Modify an existing page (replace/append/prepend) |
|
|
725
|
+
| **Chat** | `list_chat_channels` | List all channels in the workspace |
|
|
726
|
+
| | `get_chat_channel` | Get a single channel |
|
|
727
|
+
| | `create_chat_channel` | Create a new channel |
|
|
728
|
+
| | `update_chat_channel` | Update a channel |
|
|
729
|
+
| | `delete_chat_channel` | Delete a channel |
|
|
730
|
+
| | `get_chat_channel_members` | Get members of a channel |
|
|
731
|
+
| | `get_chat_channel_followers` | Get followers of a channel |
|
|
732
|
+
| | `create_chat_dm` | Create a direct message channel |
|
|
733
|
+
| | `get_chat_messages` | Get messages from a channel |
|
|
734
|
+
| | `create_chat_message` | Send a message to a channel |
|
|
735
|
+
| | `update_chat_message` | Edit a message |
|
|
736
|
+
| | `delete_chat_message` | Delete a message |
|
|
737
|
+
| | `get_chat_message_replies` | Get threaded replies to a message |
|
|
738
|
+
| | `create_chat_message_reply` | Reply to a message in a thread |
|
|
739
|
+
| | `add_chat_reaction` | Add an emoji reaction to a message |
|
|
740
|
+
| | `remove_chat_reaction` | Remove an emoji reaction |
|
|
741
|
+
| | `get_chat_reactions` | Get all reactions on a message |
|
|
742
|
+
| | `get_chat_tagged_users` | Get users tagged in a message |
|
|
743
|
+
| | `get_chat_message_subtypes` | Get post subtype IDs for the workspace |
|
|
744
|
+
| **Webhooks** | `list_webhooks` | List all webhooks in the workspace |
|
|
745
|
+
| | `create_webhook` | Create a new webhook |
|
|
746
|
+
| | `update_webhook` | Update an existing webhook |
|
|
747
|
+
| | `delete_webhook` | Delete a webhook permanently |
|
|
748
|
+
| **User Groups** | `list_user_groups` | List all user groups in the workspace |
|
|
749
|
+
| | `create_user_group` | Create a new user group |
|
|
750
|
+
| | `update_user_group` | Rename a group or add/remove members |
|
|
751
|
+
| | `delete_user_group` | Delete a user group |
|
|
752
|
+
| **Guests** | `invite_guest` | Invite a guest to the workspace (Enterprise) |
|
|
753
|
+
| | `get_guest` | Get guest details (Enterprise) |
|
|
754
|
+
| | `edit_guest` | Edit guest display name or permissions (Enterprise) |
|
|
755
|
+
| | `remove_guest` | Remove a guest from the workspace (Enterprise) |
|
|
756
|
+
| | `add_guest_to_task` | Grant guest access to a task (Enterprise) |
|
|
757
|
+
| | `remove_guest_from_task` | Revoke guest access from a task (Enterprise) |
|
|
758
|
+
| | `add_guest_to_list` | Grant guest access to a list (Enterprise) |
|
|
759
|
+
| | `remove_guest_from_list` | Revoke guest access from a list (Enterprise) |
|
|
760
|
+
| | `add_guest_to_folder` | Grant guest access to a folder (Enterprise) |
|
|
761
|
+
| | `remove_guest_from_folder` | Revoke guest access from a folder (Enterprise) |
|
|
762
|
+
| **Task Templates** | `get_task_templates` | List available workspace templates |
|
|
763
|
+
| | `create_task_from_template` | Create a task from a template |
|
|
764
|
+
| **Feedback** | `submit_feedback` | Submit feedback or bug reports |
|
|
765
|
+
|
|
766
|
+
_See [full documentation](docs/DOCUMENTATION.md) for parameters and advanced usage._
|
|
767
|
+
|
|
712
768
|
</details>
|
|
713
769
|
|
|
714
770
|
---
|
|
@@ -716,21 +772,24 @@ Restart your MCP Host (e.g., Cursor IDE). The server will validate your License
|
|
|
716
772
|
## <a name="advanced-configuration"></a>⚙️ Advanced Configuration
|
|
717
773
|
|
|
718
774
|
### Filter Available Tools
|
|
775
|
+
|
|
719
776
|
💡 **Pro Tip!** Reduce context noise for the AI by limiting available tools.
|
|
720
777
|
|
|
721
778
|
**Local (Environment Variable):**
|
|
779
|
+
|
|
722
780
|
```json
|
|
723
781
|
"ENABLED_TOOLS": "tool_1,tool_2,tool_3"
|
|
724
782
|
```
|
|
725
783
|
|
|
726
784
|
-or- **Remote (Header):**
|
|
785
|
+
|
|
727
786
|
```json
|
|
728
787
|
"X-Enabled-Tools": "tool_1,tool_2,tool_3"
|
|
729
788
|
```
|
|
730
789
|
|
|
731
790
|
### Preset Configurations
|
|
732
791
|
|
|
733
|
-
Simplify setup by using **Personas**. You can set a persona via the `CLICKUP_MCP_PERSONA` environment variable or the `X-Persona` HTTP header to automatically filter a set of tools.
|
|
792
|
+
Simplify setup by using **Personas**. You can set a persona via the `CLICKUP_MCP_PERSONA` environment variable or the `X-Persona` HTTP header to automatically filter a set of tools.
|
|
734
793
|
|
|
735
794
|
Multiple personas can be combined (e.g., `"X-Persona": "task_worker,time_specialist"`).
|
|
736
795
|
|
|
@@ -778,11 +837,6 @@ Multiple personas can be combined (e.g., `"X-Persona": "task_worker,time_special
|
|
|
778
837
|
<td style="padding: 10px;">Programmatic</td>
|
|
779
838
|
<td style="padding: 10px;">Webhooks, custom fields, bulk automation.</td>
|
|
780
839
|
</tr>
|
|
781
|
-
<tr style="border-bottom: 1px solid #eee;">
|
|
782
|
-
<td style="padding: 10px; white-space: nowrap;">🌟 <code>most_popular</code></td>
|
|
783
|
-
<td style="padding: 10px;">Common tools</td>
|
|
784
|
-
<td style="padding: 10px;">Most frequently called endpoints.</td>
|
|
785
|
-
</tr>
|
|
786
840
|
<tr style="border-bottom: 1px solid #eee;">
|
|
787
841
|
<td style="padding: 10px; white-space: nowrap;">🛡️ <code>safe_power_user</code></td>
|
|
788
842
|
<td style="padding: 10px;">Full access</td>
|
|
@@ -792,16 +846,19 @@ Multiple personas can be combined (e.g., `"X-Persona": "task_worker,time_special
|
|
|
792
846
|
</table>
|
|
793
847
|
|
|
794
848
|
**Local (Environment Variable):**
|
|
849
|
+
|
|
795
850
|
```json
|
|
796
851
|
"CLICKUP_MCP_PERSONA": "task_worker"
|
|
797
852
|
```
|
|
798
853
|
|
|
799
854
|
-or- **Remote (Header):**
|
|
855
|
+
|
|
800
856
|
```json
|
|
801
857
|
"X-Persona": "task_worker"
|
|
802
858
|
```
|
|
803
859
|
|
|
804
860
|
> **💡 Need to customize?** To view the exact tools included in each preset or to build a custom list based on a persona, see the [Personas Reference Guide](./docs/reference/personas.md).
|
|
861
|
+
|
|
805
862
|
---
|
|
806
863
|
|
|
807
864
|
### <a name="multi-workspace-support"></a>🌍 Multi-Workspace Support
|
|
@@ -809,6 +866,7 @@ Multiple personas can be combined (e.g., `"X-Persona": "task_worker,time_special
|
|
|
809
866
|
Simultaneously federate OAuth and multiple API keys to manage tasks across different authorized ClickUp accounts/workspaces in a single session. Easily move or duplicate tasks between workspaces, configure AI Agents for cross-workspace automation, and more.
|
|
810
867
|
|
|
811
868
|
**Remote (Headers):**
|
|
869
|
+
|
|
812
870
|
```json
|
|
813
871
|
{
|
|
814
872
|
"mcpServers": {
|
|
@@ -846,4 +904,4 @@ This software makes use of third-party APIs and may reference trademarks or bran
|
|
|
846
904
|
|
|
847
905
|
<div align="center">
|
|
848
906
|
<sub>Created by <a href="https://github.com/taazkareem">taazkareem</a></sub>
|
|
849
|
-
</div>
|
|
907
|
+
</div>
|