Package Exports

@chykalophia/clickup-mcp-server
@chykalophia/clickup-mcp-server/build/index-enhanced.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@chykalophia/clickup-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ClickUp MCP Server - Core Package

ClickUp MCP Server Logo

A comprehensive Model Context Protocol (MCP) server providing AI assistants with complete ClickUp integration. Features 177+ core tools, production-grade security, and full GitHub Flavored Markdown support.

🚀 Quick Start

Installation

npm install @chykalophia/clickup-mcp-server

Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "@chykalophia/clickup-mcp-server"],
      "env": {
        "CLICKUP_API_TOKEN": "YOUR_API_TOKEN_HERE"
      }
    }
  }
}

🛠️ Features

177+ Core Tools

Tasks: Create, update, delete, bulk operations, merging
Lists & Spaces: Complete CRUD operations with safeguards
Comments: Rich markdown support with formatting
Attachments: Upload, download, security validation
Custom Fields: All field types with bulk operations
Time Tracking: Entries, timers, analytics
Goals: All goal types with progress tracking
Dependencies: Relationships and conflict detection
Webhooks: Real-time processing with HMAC validation

Security Features

Zero Vulnerabilities: Comprehensive security audit
Input Validation: XSS and injection prevention
Rate Limiting: 1000 API, 100 webhook, 10 upload/min
HMAC Validation: Secure webhook authentication
File Security: Path traversal prevention, size limits

Markdown Support

GitHub Flavored Markdown: Headers, lists, code blocks, tables
Smart Processing: Auto-detection and conversion
ClickUp Optimization: Proper formatting for ClickUp API

📋 Tool Examples

Create a Task

clickup_create_task({
  list_id: "123456789",
  name: "Project Setup",
  description: "# Setup\n\n- [ ] Initialize repository\n- [ ] Configure CI/CD",
  priority: 3,
  assignees: [12345]
})

Bulk Operations

clickup_bulk_create_tasks({
  list_id: "123456789",
  tasks: [
    { name: "Task 1", description: "First task" },
    { name: "Task 2", description: "Second task" }
  ]
})

Add Comment with Markdown

clickup_create_task_comment({
  task_id: "abc123",
  comment_text: "## Status Update\n\n**Progress**: 75% complete\n\n```javascript\nconst status = 'in-progress';\n```"
})

🔧 Configuration File Locations

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Cline VSCode: ~/.vscode/extensions/saoudrizwan.claude-dev/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

🔑 Get ClickUp API Token

Log in to ClickUp
Go to Settings → Apps
Click Generate API Token
Copy the token for your configuration

📚 Documentation

@chykalophia/clickup-intelligence-mcp-server - AI-powered project intelligence
@chykalophia/clickup-mcp-shared - Shared utilities

📄 License

MIT - see LICENSE file for details.

@chykalophia/clickup-mcp-server