Clickup MCP

🚀 clickup-mcp

A lightweight ClickUp MCP server focused on task management, offering 37 tools with token-optimized responses. API responses are automatically slimmed from thousands of characters to essentials.

🚀 Quick Start

This ClickUp MCP server is designed to streamline task management by optimizing API responses. It significantly reduces the amount of data returned, leading to faster responses and lower costs.

✨ Features

• Token-Optimized Responses: Automatically slim API responses, reducing the number of characters and saving tokens.
• 37 Tools: Cover various aspects of task management, including navigation, task CRUD, custom fields, tags, checklists, dependencies, comments, and workspace members.

📦 Installation

You can install the package globally or run it directly using npx.

Global Installation

npm install -g @cavort-it-systems/clickup-mcp

Run Directly

npx @cavort-it-systems/clickup-mcp

💻 Usage Examples

Configuration

Claude Code CLI

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- npx @cavort-it-systems/clickup-mcp

Claude Desktop / Manual

Add the following to your MCP config (~/.claude.json or Claude Desktop settings):

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@cavort-it-systems/clickup-mcp"],
      "env": {
        "CLICKUP_API_TOKEN": "your-token"
      }
    }
  }
}

From Source

git clone https://github.com/cvrt-jh/clickup-mcp.git
cd clickup-mcp
npm install && npm run build

Then configure with the built path:

claude mcp add clickup -e CLICKUP_API_TOKEN=your-token -- node /path/to/clickup-mcp/build/index.js

Get Your API Token

1. Go to ClickUp Settings > Apps.
2. Generate a Personal API Token.
3. Set it as CLICKUP_API_TOKEN.

Response Slimming

All responses are automatically trimmed to save tokens. Here are some examples:

clickup_whoami

// Before (ClickUp API raw)
{"user":{"id":12345678,"username":"Jane Doe","email":"jane@example.com","color":"#0388d1",
"profilePicture":"https://attachments.clickup.com/...","initials":"JD",
"week_start_day":1,"global_font_support":true,"timezone":"Europe/Berlin"},
"teams":{"teams":[{"id":"99999999","name":"My Workspace","color":"#40BC86",
"avatar":"https://attachments2.clickup.com/...?Expires=...&Key-Pair-Id=...&Signature=...",
"members":[{"user":{"id":11111111,"username":"Bob Smith","email":"bob@example.com",
"color":"#aa2fff","profilePicture":null,"initials":"BS","role":4,"role_subtype":2,
"role_key":"guest","custom_role":null,"last_active":"...","date_joined":"...",
"date_invited":"..."},"invited_by":{"id":22222222,...},
"can_see_time_spent":true,...}, ...]}]}}

// After (slimmed)
{"id":12345678,"username":"Jane Doe","email":"jane@example.com",
"timezone":"Europe/Berlin","workspaces":[{"id":"99999999",
"name":"My Workspace","member_count":4}]}

clickup_create_comment

// Before
{"id":90150191300876,"hist_id":"...","date":1770053982842,
"version":{"object_type":"comment","object_id":"...","workspace_id":99999999,
"operation":"c","data":{"context":{"root_parent_type":1,"is_chat":false,
"audit_context":{"userid":12345678,"current_time":...,"route":"*"},...},...},...}}

// After
{"id":90150191300876,"date":1770053982842}

Tools (37)

Navigation (7)

• clickup_whoami - Current user + workspaces
• clickup_get_spaces - Spaces in workspace
• clickup_get_folders - Folders in space
• clickup_get_lists - Lists in folder or space
• clickup_get_list - Single list details
• clickup_create_list - Create list in folder or space
• clickup_delete_list - Delete a list (permanent)

Task CRUD (5)

• clickup_get_task - Get task by ID
• clickup_create_task - Create task with all fields
• clickup_update_task - Update any task field
• clickup_get_tasks - List tasks in a list
• clickup_search_tasks - Search tasks across workspace

Custom Fields (1)

• clickup_set_custom_field - Set custom field value

Tags (6)

• clickup_get_space_tags - List space tags
• clickup_create_space_tag - Create tag
• clickup_edit_space_tag - Edit tag
• clickup_delete_space_tag - Delete tag
• clickup_add_tag_to_task - Tag a task
• clickup_remove_tag_from_task - Untag a task

Checklists (6)

• clickup_create_checklist - Create checklist
• clickup_edit_checklist - Edit checklist
• clickup_delete_checklist - Delete checklist
• clickup_create_checklist_item - Add item
• clickup_edit_checklist_item - Edit item
• clickup_delete_checklist_item - Delete item

Dependencies (4)

• clickup_add_dependency - Add dependency
• clickup_delete_dependency - Remove dependency
• clickup_add_task_link - Link tasks
• clickup_delete_task_link - Unlink tasks

Comments (5)

• clickup_create_comment - Add comment
• clickup_get_comments - Get comments
• clickup_update_comment - Edit/resolve comment
• clickup_create_reply - Threaded reply
• clickup_get_replies - Get replies

Delete Task (1)

• clickup_delete_task - Delete a task

Workspace Members (2)

• clickup_get_workspace_members - All workspace members
• clickup_get_list_members - List-specific members

🔧 Technical Details

Architecture

src/
  index.ts          # Entry: McpServer + StdioServerTransport
  client.ts         # ClickUp API v2 fetch wrapper
  types.ts          # Shared Zod schemas + jsonResult helper
  slim.ts           # Response slimming transformers
  tools/
    navigation.ts   # 7 tools
    tasks.ts        # 7 tools (CRUD + custom fields + delete)
    tags.ts         # 6 tools
    checklists.ts   # 6 tools
    dependencies.ts # 4 tools
    comments.ts     # 5 tools
    members.ts      # 2 tools

📄 License

This project is licensed under the MIT License.