{"_id":"@djclarkson/clickup-mcp-server","_rev":"5-3796ac64b09cc75ea0495b2bf063225d","name":"@djclarkson/clickup-mcp-server","dist-tags":{"latest":"0.8.5"},"versions":{"0.8.4":{"name":"@djclarkson/clickup-mcp-server","version":"0.8.4","keywords":["clickup","mcp","ai","tasks","project-management","model-context-protocol","clickup-server","clickup-mcp-server","task-management","productivity","automation","workflow","team-collaboration","artificial-intelligence","project-tracking","task-tracking","project-planning","clickup-integration","clickup-api","clickup-automation","task-organization","project-organization"],"author":{"name":"Talib Kareem"},"license":"MIT","_id":"@djclarkson/clickup-mcp-server@0.8.4","maintainers":[{"name":"djclarkson","email":"david.clarkson@gmail.com"}],"homepage":"https://github.com/djclarkson/clickup-mcp-server#readme","bugs":{"url":"https://github.com/djclarkson/clickup-mcp-server/issues"},"bin":{"clickup-mcp-server":"build/index.js"},"dist":{"shasum":"549f751611c6ca6e9ab1e6b32a3c78e450484922","tarball":"https://registry.npmjs.org/@djclarkson/clickup-mcp-server/-/clickup-mcp-server-0.8.4.tgz","fileCount":58,"integrity":"sha512-6pWs0+uepd38yoOIUyZWUpyhUraLmecTKXpPXkpc/SzptvGaJCPxVPH9HGwCgKhF3L4w4KzTTeaxCYgthY0bBw==","signatures":[{"sig":"MEQCIDtUlckDaQPbElncFVs46cYPYkAmhnIMPdiNQp/bDlsHAiBP7GzxNV0zjysURz2YUapZvkFZMgv9gqkEw1ie7AwK6g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":499394},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0 <23.0.0"},"gitHead":"2af988de6881b41b05acd1273270ad8cb136ba31","scripts":{"dev":"tsc -w","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","prepare":"npm run build"},"_npmUser":{"name":"djclarkson","actor":{"name":"djclarkson","type":"user","email":"david.clarkson@gmail.com"},"email":"david.clarkson@gmail.com"},"repository":{"url":"git+https://github.com/djclarkson/clickup-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"ClickUp MCP Server - Enhanced fork with task dependency management and parameter fixes","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.23.8","cors":"^2.8.5","axios":"^1.6.7","dotenv":"^16.5.0","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.11.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/cors":"^2.8.17","@types/node":"^20.11.16","@types/express":"^5.0.1"},"_npmOperationalInternal":{"tmp":"tmp/clickup-mcp-server_0.8.4_1750907708679_0.9423946965235857","host":"s3://npm-registry-packages-npm-production"}},"0.8.5":{"name":"@djclarkson/clickup-mcp-server","version":"0.8.5","description":"ClickUp MCP Server - Enhanced fork with task dependency management and parameter fixes","type":"module","main":"build/index.js","bin":{"clickup-mcp-server":"build/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","dev":"tsc -w","prepare":"npm run build"},"keywords":["clickup","mcp","ai","tasks","project-management","model-context-protocol","clickup-server","clickup-mcp-server","task-management","productivity","automation","workflow","team-collaboration","artificial-intelligence","project-tracking","task-tracking","project-planning","clickup-integration","clickup-api","clickup-automation","task-organization","project-organization"],"author":{"name":"Talib Kareem"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/djclarkson/clickup-mcp-server.git"},"bugs":{"url":"https://github.com/djclarkson/clickup-mcp-server/issues"},"homepage":"https://github.com/djclarkson/clickup-mcp-server#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.11.3","axios":"^1.6.7","cors":"^2.8.5","dotenv":"^16.5.0","express":"^5.1.0","zod":"^3.23.8"},"devDependencies":{"@types/cors":"^2.8.17","@types/express":"^5.0.1","@types/node":"^20.11.16","typescript":"^5.3.3"},"engines":{"node":">=18.0.0 <23.0.0"},"publishConfig":{"access":"public"},"_id":"@djclarkson/clickup-mcp-server@0.8.5","gitHead":"6a23ee5fab58dda155a981fde52f5f03859f46bb","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-cIx73Kp/3u7YnFtCdfiftLJPn+fOJi3SCXg/VN9je/meqxJRgJAp9wcvNK5+FCB5K6le4KWvtWCpGmMu83yOhw==","shasum":"21e760f9824d5d493fc0224d82781283264da96b","tarball":"https://registry.npmjs.org/@djclarkson/clickup-mcp-server/-/clickup-mcp-server-0.8.5.tgz","fileCount":58,"unpackedSize":500573,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCbyRkCZcJLcuxwH4it3vIJuusVUysgWn9S7LE2VEUWSwIgLW7bKv7kLH+mRh3mB6jLaXxoOWpgOuqqYI7apoloVKo="}]},"_npmUser":{"name":"djclarkson","email":"david.clarkson@gmail.com","actor":{"name":"djclarkson","email":"david.clarkson@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"djclarkson","email":"david.clarkson@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clickup-mcp-server_0.8.5_1750908363044_0.2848072940080819"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-26T03:15:08.593Z","modified":"2025-06-26T03:26:03.503Z","0.8.3":"2025-06-26T02:54:35.249Z","0.8.4":"2025-06-26T03:15:08.880Z","0.8.5":"2025-06-26T03:26:03.299Z"},"bugs":{"url":"https://github.com/djclarkson/clickup-mcp-server/issues"},"author":{"name":"Talib Kareem"},"license":"MIT","homepage":"https://github.com/djclarkson/clickup-mcp-server#readme","keywords":["clickup","mcp","ai","tasks","project-management","model-context-protocol","clickup-server","clickup-mcp-server","task-management","productivity","automation","workflow","team-collaboration","artificial-intelligence","project-tracking","task-tracking","project-planning","clickup-integration","clickup-api","clickup-automation","task-organization","project-organization"],"repository":{"type":"git","url":"git+https://github.com/djclarkson/clickup-mcp-server.git"},"description":"ClickUp MCP Server - Enhanced fork with task dependency management and parameter fixes","maintainers":[{"name":"djclarkson","email":"david.clarkson@gmail.com"}],"readme":"# ClickUp MCP Server (Enhanced Fork)\n\n<img src=\"assets/images/clickup_mcp_server_social_image.png\" alt=\"ClickUp MCP Server\" width=\"100%\">\n\n[![NPM Version](https://img.shields.io/npm/v/@djclarkson/clickup-mcp-server.svg?style=flat&logo=npm)](https://www.npmjs.com/package/@djclarkson/clickup-mcp-server)\n[![GitHub Stars](https://img.shields.io/github/stars/djclarkson/clickup-mcp-server?style=flat&logo=github)](https://github.com/djclarkson/clickup-mcp-server/stargazers)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-brightgreen.svg)](https://github.com/djclarkson/clickup-mcp-server/graphs/commit-activity)\n\n> **Enhanced Fork** of the original [ClickUp MCP Server](https://github.com/TaazKareem/clickup-mcp-server) with additional features and improvements.\n\nA 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.\n\n## 🚀 New Features in This Fork\n\n### ✨ **Task Dependencies Management**\n- **Create Dependencies**: Link tasks with waiting_on/blocking relationships\n- **Bulk Dependencies**: Add multiple dependencies efficiently\n- **Dependency Visualization**: View complete dependency chains\n- **Circular Dependency Prevention**: Automatic validation to prevent cycles\n- **Smart Dependency Resolution**: Works with task IDs or names\n\n### 🔧 **Parameter Handling Fixes**\n- Fixed parameter validation issues in task operations\n- Improved error handling for missing required parameters\n- Enhanced parameter type checking and conversion\n- Better support for optional parameters in bulk operations\n\n### 🧪 **Enhanced Testing**\n- Comprehensive test suite for dependency operations\n- Mock-based testing for reliable CI/CD\n- Parameter validation test coverage\n- Edge case handling verification\n\n## Quick Start\n\n### NPM Installation (Recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"ClickUp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@djclarkson/clickup-mcp-server@latest\"\n      ],\n      \"env\": {\n        \"CLICKUP_API_KEY\": \"your-clickup-api-key-here\",\n        \"CLICKUP_TEAM_ID\": \"your-clickup-team-id-here\",\n        \"DOCUMENT_SUPPORT\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### Command Line Usage\n\n```bash\nnpx -y @djclarkson/clickup-mcp-server@latest --env CLICKUP_API_KEY=your-api-key --env CLICKUP_TEAM_ID=your-team-id\n```\n\n## Setup\n\n1. **Get your credentials:**\n   - ClickUp API key from [ClickUp Settings](https://app.clickup.com/settings/apps)\n   - Team ID from your ClickUp workspace URL\n\n2. **Install via npm:**\n   - Use the configuration above in your MCP client\n   - Or run directly with npx\n\n3. **Start managing tasks with natural language!**\n\n## Enhanced Features\n\n### 🔗 **Task Dependencies** (New!)\n\nCreate and manage task dependencies with natural language:\n\n```javascript\n// Create a dependency\n\"Make Task A depend on Task B being completed\"\n\n// View dependencies\n\"Show me all dependencies for Project Alpha tasks\"\n\n// Bulk dependencies\n\"Create dependencies: Task 1 depends on Tasks 2,3,4\"\n```\n\n**Available Dependency Tools:**\n- `get_task_dependencies` - View task dependency chains\n- `add_bulk_dependencies` - Create multiple dependencies efficiently\n\n### 📝 **Enhanced Task Management**\n\nAll original features plus improved parameter handling:\n- ✅ Create, update, and delete tasks\n- ✅ Move and duplicate tasks anywhere\n- ✅ Support for single and bulk operations\n- ✅ Set start/due dates with natural language\n- ✅ Create and manage subtasks\n- ✅ Add comments and attachments\n- ✅ **Fixed parameter validation issues**\n\n### 🏷️ **Tag Management**\n- Create, update, and delete space tags\n- Add and remove tags from tasks\n- Use natural language color commands\n- Automatic contrasting foreground colors\n- View all space tags\n- Tag-based task organization\n\n### ⏱️ **Time Tracking**\n- View time entries for tasks\n- Start/stop time tracking\n- Add manual time entries\n- Delete time entries\n- View currently running timer\n- Track billable and non-billable time\n\n### 🌳 **Workspace Organization**\n- Navigate spaces, folders, and lists\n- Create and manage folders\n- Organize lists within spaces\n- Create lists in folders\n- View workspace hierarchy\n- Efficient path navigation\n\n### 👥 **Member Management**\n- Find workspace members by name or email\n- Resolve assignees for tasks\n- View member details and permissions\n- Assign tasks to users during creation and updates\n- Support for user IDs, emails, or usernames\n\n### 📄 **Document Management**\n- Document listing through workspace\n- Document page listing and details\n- Document creation\n- Document page updates (append & prepend)\n\n## Available Tools (38+ Total)\n\nThis fork includes all original tools plus new dependency management tools:\n\n| Category | Tools | Description |\n|----------|-------|-------------|\n| **Dependencies** | `get_task_dependencies`, `add_bulk_dependencies` | **New!** Manage task dependencies |\n| **Task Management** | 16 tools | Create, update, delete, move, duplicate tasks |\n| **Workspace** | 8 tools | Navigate spaces, folders, lists |\n| **Tags** | 6 tools | Manage space tags and task tagging |\n| **Time Tracking** | 6 tools | Track time on tasks |\n| **Members** | 3 tools | Manage workspace members |\n| **Documents** | 6 tools | Manage ClickUp documents |\n\n[View complete API reference](docs/api-reference.md)\n\n## Configuration Options\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `CLICKUP_API_KEY` | Your ClickUp API key | Required |\n| `CLICKUP_TEAM_ID` | Your ClickUp team ID | Required |\n| `DOCUMENT_SUPPORT` | Enable document management | `false` |\n| `DISABLED_TOOLS` | Comma-separated list of tools to disable | None |\n| `ENABLE_SSE` | Enable HTTP/SSE transport | `false` |\n| `PORT` | Port for HTTP server | `3231` |\n\n## HTTP Transport Support\n\nThe server supports both modern **HTTP Streamable** transport (MCP Inspector compatible) and legacy **SSE (Server-Sent Events)** transport:\n\n```json\n{\n  \"mcpServers\": {\n    \"ClickUp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@djclarkson/clickup-mcp-server@latest\"],\n      \"env\": {\n        \"CLICKUP_API_KEY\": \"your-api-key\",\n        \"CLICKUP_TEAM_ID\": \"your-team-id\",\n        \"ENABLE_SSE\": \"true\",\n        \"PORT\": \"3231\"\n      }\n    }\n  }\n}\n```\n\n**Endpoints:**\n- **Primary**: `http://127.0.0.1:3231/mcp` (Streamable HTTP)\n- **Legacy**: `http://127.0.0.1:3231/sse` (SSE for backwards compatibility)\n\n## Fork Differences\n\nThis enhanced fork maintains 100% compatibility with the original while adding:\n\n1. **Task Dependencies**: Complete dependency management system\n2. **Parameter Fixes**: Resolved parameter validation issues\n3. **Enhanced Testing**: Comprehensive test coverage\n4. **Better Error Handling**: Improved error messages and validation\n5. **Code Quality**: Additional type safety and documentation\n\n## Contributing\n\nThis fork welcomes contributions! Please see [CONTRIBUTING.md](.development-files/CONTRIBUTING.md) for guidelines.\n\n## Original Project\n\nThis is an enhanced fork of the excellent [ClickUp MCP Server](https://github.com/TaazKareem/clickup-mcp-server) by [Talib Kareem](https://github.com/TaazKareem). All credit for the original architecture and implementation goes to the original author.\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Support\n\n- 🐛 **Issues**: [GitHub Issues](https://github.com/djclarkson/clickup-mcp-server/issues)\n- 💡 **Features**: Submit feature requests via issues\n- 🔧 **Original Project**: [TaazKareem/clickup-mcp-server](https://github.com/TaazKareem/clickup-mcp-server)\n","readmeFilename":"README.md"}