@chykalophia/clickup-mcp-server

v5.0.3

Published

2 months ago

An intelligent Model Context Protocol server for ClickUp API integration with 177+ tools, AI-powered efficiency optimization, smart tool suggestions, and context-aware workflow recommendations

ClickUp MCP Server - Core Package

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

🤝 Related Packages

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

📄 License

MIT - see LICENSE file for details.