ClickUp MCP Server (Enhanced Fork)

![NPM Version](https://www.npmjs.com/package/@djclarkson/clickup-mcp-server) ![GitHub Stars](https://github.com/djclarkson/clickup-mcp-server/stargazers) ![Maintenance](https://github.com/djclarkson/clickup-mcp-server/graphs/commit-activity)

Enhanced Fork of the original ClickUp MCP Server with additional features and improvements.

A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This enhanced fork adds task dependency management and fixes critical parameter handling issues while maintaining full compatibility with the original.

🚀 New Features in This Fork

✨ Task Dependencies Management

Create Dependencies: Link tasks with waiting_on/blocking relationships
Bulk Dependencies: Add multiple dependencies efficiently
Dependency Visualization: View complete dependency chains
Circular Dependency Prevention: Automatic validation to prevent cycles
Smart Dependency Resolution: Works with task IDs or names

🔧 Parameter Handling Fixes

Fixed parameter validation issues in task operations
Improved error handling for missing required parameters
Enhanced parameter type checking and conversion
Better support for optional parameters in bulk operations

🧪 Enhanced Testing

Comprehensive test suite for dependency operations
Mock-based testing for reliable CI/CD
Parameter validation test coverage
Edge case handling verification

Quick Start

NPM Installation (Recommended)

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": [
        "-y",
        "@djclarkson/clickup-mcp-server@latest"
      ],
      "env": {
        "CLICKUP_API_KEY": "your-clickup-api-key-here",
        "CLICKUP_TEAM_ID": "your-clickup-team-id-here",
        "DOCUMENT_SUPPORT": "true"
      }
    }
  }
}

Command Line Usage

npx -y @djclarkson/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id

Setup

Get your credentials:

ClickUp API key from ClickUp Settings
Team ID from your ClickUp workspace URL

Install via npm:

Use the configuration above in your MCP client
Or run directly with npx

Start managing tasks with natural language!

Enhanced Features

🔗 Task Dependencies (New!)

Create and manage task dependencies with natural language:

// Create a dependency
"Make Task A depend on Task B being completed"

// View dependencies
"Show me all dependencies for Project Alpha tasks"

// Bulk dependencies
"Create dependencies: Task 1 depends on Tasks 2,3,4"

Available Dependency Tools:

get_task_dependencies - View task dependency chains
add_bulk_dependencies - Create multiple dependencies efficiently

📝 Enhanced Task Management

All original features plus improved parameter handling:

✅ Create, update, and delete tasks
✅ Move and duplicate tasks anywhere
✅ Support for single and bulk operations
✅ Set start/due dates with natural language
✅ Create and manage subtasks
✅ Add comments and attachments
✅ Fixed parameter validation issues

🏷️ Tag Management

Create, update, and delete space tags
Add and remove tags from tasks
Use natural language color commands
Automatic contrasting foreground colors
View all space tags
Tag-based task organization

⏱️ Time Tracking

View time entries for tasks
Start/stop time tracking
Add manual time entries
Delete time entries
View currently running timer
Track billable and non-billable time

🌳 Workspace Organization

Navigate spaces, folders, and lists
Create and manage folders
Organize lists within spaces
Create lists in folders
View workspace hierarchy
Efficient path navigation

🧰 Universal ClickUp API Access (New!)

Call any ClickUp endpoint (dashboards, docs, custom fields, spaces, tags, lists, etc.)
Works with GET/POST/PUT/PATCH/DELETE
Pass raw query params, headers, and request bodies
Reuses shared auth, rate limiting, and error handling

👥 Member Management

Find workspace members by name or email
Resolve assignees for tasks
View member details and permissions
Assign tasks to users during creation and updates
Support for user IDs, emails, or usernames

📄 Document Management

Document listing through workspace
Document page listing and details
Document creation
Document page updates (append & prepend)

Available Tools (38+ Total)

This fork includes all original tools plus new dependency management tools:

| Category | Tools | Description | |----------|-------|-------------| | Dependencies | get_task_dependencies, add_bulk_dependencies | New! Manage task dependencies | | Task Management | 16 tools | Create, update, delete, move, duplicate tasks | | Workspace | 8 tools | Navigate spaces, folders, lists | | Tags | 6 tools | Manage space tags and task tagging | | Time Tracking | 6 tools | Track time on tasks | | Members | 3 tools | Manage workspace members | | Documents | 6 tools | Manage ClickUp documents | | Custom API | 1 tool | Raw access to any ClickUp endpoint |

View complete API reference

Configuration Options

| Option | Description | Default | |--------|-------------|---------| | CLICKUP_API_KEY | Your ClickUp API key | Required | | CLICKUP_TEAM_ID | Your ClickUp team ID | Required | | DOCUMENT_SUPPORT | Enable document management | false | | DISABLED_TOOLS | Comma-separated list of tools to disable | None | | ENABLE_SSE | Enable HTTP/SSE transport | false | | PORT | Port for HTTP server | 3231 |

HTTP Transport Support

The server supports both modern HTTP Streamable transport (MCP Inspector compatible) and legacy SSE (Server-Sent Events) transport:

{
  "mcpServers": {
    "ClickUp": {
      "command": "npx",
      "args": ["-y", "@djclarkson/clickup-mcp-server@latest"],
      "env": {
        "CLICKUP_API_KEY": "your-api-key",
        "CLICKUP_TEAM_ID": "your-team-id",
        "ENABLE_SSE": "true",
        "PORT": "3231"
      }
    }
  }
}

Endpoints:

Primary: http://127.0.0.1:3231/mcp (Streamable HTTP)
Legacy: http://127.0.0.1:3231/sse (SSE for backwards compatibility)

Deploying to smitheree.ai

For the most stable smitheree.ai experience, use the streamable HTTP transport on the default MCP port (3231) with the /mcp path. The included smithery.yaml is preconfigured for smitheree.ai to run npm run start inside a container, expose port 3231, and advertise the /mcp HTTP endpoint.

Fork Differences

This enhanced fork maintains 100% compatibility with the original while adding:

Task Dependencies: Complete dependency management system
Parameter Fixes: Resolved parameter validation issues
Enhanced Testing: Comprehensive test coverage
Better Error Handling: Improved error messages and validation
Code Quality: Additional type safety and documentation

Contributing

This fork welcomes contributions! Please see CONTRIBUTING.md for guidelines.

Original Project

This is an enhanced fork of the excellent ClickUp MCP Server by Talib Kareem. All credit for the original architecture and implementation goes to the original author.

License

MIT License - see LICENSE for details.

Support

🐛 Issues: GitHub Issues
💡 Features: Submit feature requests via issues
🔧 Original Project: TaazKareem/clickup-mcp-server

ClickUp MCP Server (Enhanced Fork)