Atlas / MCP servers / nazruden / ClickUp

ClickUpBLOCK

mcp/nazruden/clickup

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.

Verdict
BLOCK
Grade
F
Trust score
59 /100
Exposed tools
31 13r · 14w · 4d
Transport
stdio
License
MIT
Stars
23
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://smithery.ai/server/@Nazruden/clickup-mcp-server) [](https://badge.fury.io/js/%40nazruden%2Fclickup-server) [](https://opensource.org/licenses/MIT)

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.

This server runs via Stdio as per the MCP specification when invoked by an MCP client.

Quick Start

This server uses your ClickUp Personal API Token for authentication.

  1. Generate a Personal API Token: In your ClickUp settings, navigate to "My Settings" > "Apps" and generate a token.
  2. Configure your MCP Client (e.g., Claude for Desktop): Set the required environment variable when configuring the server for your client.

Example configuration snippet for an MCP client:

{
"mcpServers": {
"clickup": {
"command": "npx",
"args": ["@nazruden/clickup-server"],
"env": {
"CLICKUP_PERSONAL_TOKEN": "your_personal_api_token_here"
}
}
}
}
  1. Restart your MCP Client.

The server will be automatically downloaded and started by the MCP client when needed.

Installing via Smithery

To install ClickUp MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client cla
Read from source at commit b4cbb7fce802OBSERVED · 2026-10-09
Advertisement
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add clickup-server --env CLICKUP_CLIENT_SECRET=${CLICKUP_CLIENT_SECRET} --env CLICKUP_PERSONAL_TOKEN=${CLICKUP_PERSONAL_TOKEN} --env CLICKUP_PERSONAL_TOKEN_INTEGRATION=${CLICKUP_PERSONAL_TOKEN_INTEGRATION} --env ENCRYPTION_KEY=${ENCRYPTION_KEY} -- npx -y @nazruden/[email protected]
claude-desktop
{
  "mcpServers": {
    "clickup-server": {
      "command": "npx",
      "args": [
        "-y",
        "@nazruden/[email protected]"
      ],
      "env": {
        "CLICKUP_CLIENT_SECRET": "${CLICKUP_CLIENT_SECRET}",
        "CLICKUP_PERSONAL_TOKEN": "${CLICKUP_PERSONAL_TOKEN}",
        "CLICKUP_PERSONAL_TOKEN_INTEGRATION": "${CLICKUP_PERSONAL_TOKEN_INTEGRATION}",
        "ENCRYPTION_KEY": "${ENCRYPTION_KEY}"
      }
    }
  }
}
03

Exposed tools (31)

13 read · 14 write · 4 destructive. Blast radius: 4 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

ToolRiskDescription
clickup_create_boardwriteCreate a new board view in a ClickUp space.
clickup_create_docwriteCreates a new Doc within a Workspace.
clickup_create_doc_pagewriteCreates a new page within a specific Doc.
clickup_create_folderwriteCreates a new Folder within a Space.
clickup_create_listwriteCreates a new List within a Folder or Space.
clickup_create_spacewriteCreates a new Space within a Workspace.
clickup_create_taskwriteCreate a new task in ClickUp workspace
clickup_create_viewwriteCreates a new View within a Team, Space, Folder, or List.
clickup_delete_folderdestructiveDeletes a Folder.
clickup_delete_spacedestructiveDeletes a Space.
clickup_delete_viewdestructiveDeletes a View.
clickup_edit_doc_page_contentwriteUpdates the content and/or title of a specific Doc page.
clickup_get_custom_fieldsreadRetrieves all accessible Custom Fields for a given List.
clickup_get_doc_page_contentreadRetrieves the content (Markdown) of a specific Doc page.
clickup_get_doc_pagesreadRetrieves the list of pages within a specific Doc.
clickup_get_folderreadRetrieves details for a specific Folder.
clickup_get_foldersreadRetrieves all Folders within a given Space.
clickup_get_listsreadGet all lists in a specific folder.
clickup_get_spacereadRetrieves details for a specific Space.
clickup_get_spacesreadRetrieves all Spaces for a given Workspace (Team).
clickup_get_teamsreadGet all teams (workspaces) accessible to the authenticated user.
clickup_get_view_detailsreadRetrieves details for a specific View.
clickup_get_view_tasksreadRetrieves tasks belonging to a specific View.
clickup_get_viewsreadRetrieves all Views for a given parent (Team, Space, Folder, or List).
clickup_remove_task_custom_field_valuedestructiveRemoves the value of a Custom Field from a specific task.
clickup_search_docsreadSearches for Docs within a Workspace (Team).
clickup_set_task_custom_field_valuewriteSets the value of a Custom Field on a specific task.
clickup_update_folderwriteUpdates an existing Folder.
clickup_update_spacewriteUpdates an existing Space.
clickup_update_taskwriteUpdate an existing task in ClickUp
clickup_update_viewwriteUpdates an existing View. Note: ClickUp API v2 /view/{view_id} PUT endpoint currently has known issues (Internal Server Error).
04

Trust audit

BLOCKgrade F · trust 59/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfaceWARN
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (3 observation(s))
Network
declared (6 observation(s))
Shell
declared (6 observation(s))
Dependencies
not all pinned
Secrets in source
none-found

Findings (19)

HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
scripts/release.js:90
exec(`npm version ${VERSION_TYPE} --no-git-tag-version`);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
scripts/release.js:106
exec(`git commit -m "chore(release): bump version to ${newVersion}"`);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
scripts/release.js:109
exec(`git tag -a v${newVersion} -m "Release v${newVersion}"`);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
HIGHCode injection · code.eval_exec · CWE-78, CWE-94, CWE-95
scripts/release.js:113
exec(`git push origin v${newVersion}`);
Why it matters. evaluates text as code
Fix. remove; use a parser or a dispatch table
MEDIUMInformation disclosure · disclose.log_secret · CWE-209, CWE-532
src/__integration__/setup/integration.setup.ts:43
console.log(`  - Token: ${INTEGRATION_CONFIG.clickupToken.substring(0, 20)}...`);
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
clickup_delete_folder, clickup_delete_space, clickup_delete_view, clickup_remove_task_custom_field_value
Why it matters. 4 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWInventory / provenance · inv.hidden_file · CWE-1104
.ai/.aijournal
.aijournal
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
.ai/memory-bank/.aijournal
.aijournal
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
.aijournal
.aijournal
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
.env.test
.env.test
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWInventory / provenance · inv.hidden_file · CWE-1104
.eslintrc.js
.eslintrc.js
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__integration__/services/clickup.service.integration.test.ts:1
import "../../__integration__/setup/integration.setup.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__integration__/services/clickup.service.integration.test.ts:2
import { ClickUpService } from "../../services/clickup.service.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__integration__/setup/clickup.cleanup.ts:1
import { ClickUpService } from "../../services/clickup.service.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__integration__/setup/integration.setup.ts:6
path: path.resolve(__dirname, "../../../.env.integration"),
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/__integration__/tools/task.tools.integration.test.ts:1
import "../../__integration__/setup/integration.setup.js";
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
clickup-mcp-server/package.json
axios, dotenv, zod, @types/jest, @types/node, jest, ts-jest, ts-node
Why it matters. 9 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, axios, cross-env, dotenv, express, @types/express, @types/jest, @types/node
Why it matters. 20 dependency range(s) float
Fix. pin exact versions or ship a lockfile
INFOInventory / provenance · inv.oversize · CWE-1104
docs/673cf4cfdca96a0019533cad.json
docs/673cf4cfdca96a0019533cad.json
Why it matters. 1142801 bytes not read

Gates applied: no_behavioural_pass.

Audited 2026-10-09 · audit v0.4.1 · source sha b4cbb7fce802full audit observations/trust-audit/mcp-server/nazruden__clickup.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-09b4cbb7fce802BLOCKF59first audit
06

Questions

What is the ClickUp MCP server?

A Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.

What tools does ClickUp expose?

31 in total: 13 read-only, 14 that write, and 4 that can delete or overwrite (clickup_delete_folder, clickup_delete_space, clickup_delete_view, clickup_remove_task_custom_field_value). Every one is listed on this page with its risk.

Is ClickUp safe to connect to an agent?

No — not without reading the findings first. The audit graded it F (59/100) and found 4 critical or high issues in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 4 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does ClickUp need?

It reads CLICKUP_CLIENT_SECRET, CLICKUP_PERSONAL_TOKEN, CLICKUP_PERSONAL_TOKEN_INTEGRATION and ENCRYPTION_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does ClickUp run?

It speaks stdio, so it runs as a local process your client starts. It is published on npm as @nazruden/clickup-server at 1.1.5.

How current is this page?

The grade is for one exact copy of the source (b4cbb7fce802), read on 2026-10-09. The repository is watched and re-audited when it changes.

Advertisement