@taazkareem/clickup-mcp-server 0.2.4 → 0.2.6

package/Dockerfile.smithery

@@ -0,0 +1,36 @@
+# Use a Node.js base image
+FROM node:18-alpine AS builder
+
+# Set the working directory
+WORKDIR /app
+
+# Copy package files and TypeScript config
+COPY package.json package-lock.json tsconfig.json ./
+
+# Copy the source files
+COPY src/ ./src/
+
+# Install dependencies and build
+RUN npm install
+RUN npm run build
+
+# Use a smaller image for the runtime
+FROM node:18-alpine AS runtime
+
+# Set the working directory
+WORKDIR /app
+
+# Copy the build output and node_modules from the builder stage
+COPY --from=builder /app/build ./build
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+
+# Set environment variables (these will be overridden by Smithery)
+ENV CLICKUP_API_KEY=placeholder
+ENV CLICKUP_TEAM_ID=placeholder
+
+# Expose the port if needed
+EXPOSE 8080
+
+# Define the command to run the application
+CMD ["node", "build/index.js"] 

package/LICENSE

@@ -19,3 +19,9 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+Disclaimer: This software makes use of third-party APIs and may reference trademarks
+or brands owned by third parties. The use of such APIs or references does not imply 
+any affiliation with or endorsement by the respective companies. All trademarks and 
+brand names are the property of their respective owners. This project is an independent
+work and is not officially associated with or sponsored by any third-party company mentioned.

package/README.md

@@ -1,4 +1,6 @@
-# ClickUp MCP Server
+<img src="https://clickup.com/assets/brand/logo-v3-clickup-dark.svg" alt="ClickUp" height="40" style="vertical-align: middle; margin-top: -4px;">
+
+# MCP Server
 
 A Model Context Protocol (MCP) server for integrating ClickUp tasks with AI applications. This server allows AI agents to interact with ClickUp tasks, spaces, lists, and folders through a standardized protocol.
 
@@ -22,30 +24,31 @@ npx -y @taazkareem/clickup-mcp-server \
 ## Features
 
 - 🎯 **Task Management**
-  - Create, update, and delete tasks
-  - Move and duplicate tasks between lists, spaces, and folders 
-  - Bulk task operations
-  - Task details
+  - Create, update, and delete individual tasks
+  - Move and duplicate tasks between lists, spaces, and folders
+  - Create multiple tasks in bulk
+  - View and modify task details and properties
 
 - 📂 **Workspace Organization**
-  - Hierarchical tree structure with clear relationships
-  - Efficient navigation with path tracking
-  - List and folder management in spaces
-  - Smart caching to reduce API calls
-  - Name/ID-based item lookup
-
-
-- 🔄 **Smart Integration**
-  - Case-insensitive name lookups
-  - Markdown support
-  - Automatic rate limiting
-  - Error handling
-
-- 🤖 **AI Assistance**
-  - Task analysis and insights
-  - Status summaries and priorities
-  - Description assistance
-  - Relationship mapping
+  - Navigate complete workspace hierarchy (spaces, folders, lists)
+  - Tree structure with clear relationships
+  - Create and manage lists and folders
+  - Efficient path-based navigation
+
+- 🔄 **Integration Features**
+  - Name or ID-based item lookup
+  - Case-insensitive name matching
+  - Markdown formatting support
+  - Built-in API rate limiting
+  - Comprehensive error handling
+  - Clear parameter validation
+
+- 🤖 **AI-Powered Analysis**
+  - Task status summaries and overviews
+  - Priority analysis and recommendations
+  - Structured description generation
+  - Task relationship mapping
+  - Workspace organization insights
 
 ## Available Tools
 

package/build/index.js

@@ -57,7 +57,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "create_task",
-                description: "Create a new task in ClickUp. Supports direct name-based lookup for lists - no need to know the list ID. -Status will use ClickUp defaults if not specified. If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.",
+                description: "Create a new task in ClickUp. Supports direct name-based lookup for lists - no need to know the list ID. Status will use ClickUp defaults if not specified.  If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -71,7 +71,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         name: {
                             type: "string",
-                            description: "Name of the task"
+                            description: "Name of the task. Put a relevant emoji followed by a blank space before the name."
                         },
                         description: {
                             type: "string",
@@ -87,7 +87,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         priority: {
                             type: "number",
-                            description: "Priority of the task (1-4), 1 is highest priority, 4 is lowest priority. -If not specified, the task will not set a priority."
+                            description: "Priority of the task (1-4), 1 is urgent/highest priority, 4 is lowest priority. Only set this if priority is explicitly mentioned in the user's request."
                         },
                         dueDate: {
                             type: "string",
@@ -99,7 +99,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "create_bulk_tasks",
-                description: "Create multiple tasks in a ClickUp list. Supports direct name-based lookup for lists - no need to know the list ID. -Tasks will use ClickUp default status if not specified. If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.",
+                description: "Create multiple tasks in a ClickUp list. Supports direct name-based lookup for lists - no need to know the list ID. Tasks will use ClickUp default status if not specified. If the specified list doesn't exist, you can create it using create_list or create_list_in_folder.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -135,7 +135,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                                     },
                                     priority: {
                                         type: "number",
-                                        description: "Priority level (1-4), 1 is highest priority, 4 is lowest priority"
+                                        description: "Priority level (1-4), 1 is urgent/highest priority, 4 is lowest priority. Only set this if priority is explicitly mentioned in the user's request."
                                     },
                                     dueDate: {
                                         type: "string",
@@ -184,7 +184,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         priority: {
                             type: "number",
-                            description: "Priority of the list (1-4)"
+                            description: "Priority of the list (1-4). Only set this if priority is explicitly mentioned in the user's request."
                         },
                         assignee: {
                             type: "number",
@@ -354,7 +354,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                         },
                         priority: {
                             type: "number",
-                            description: "New priority of the task (1-4)"
+                            description: "New priority of the task (1-4). Only set this if priority is explicitly mentioned in the user's request."
                         },
                         dueDate: {
                             type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",
@@ -10,7 +10,9 @@
   "files": [
     "build",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "Dockerfile.smithery",
+    "smithery.yaml"
   ],
   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",

package/smithery.yaml

@@ -0,0 +1,23 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+dockerfile: Dockerfile.smithery
+
+startCommand:
+  type: stdio
+  configSchema:
+    # JSON Schema defining the configuration options for the MCP.
+    type: object
+    required:
+      - clickupApiKey
+      - clickupTeamId
+    properties:
+      clickupApiKey:
+        type: string
+        description: Your ClickUp API key.
+      clickupTeamId:
+        type: string
+        description: Your ClickUp Team ID.
+  commandFunction:
+    # A function that produces the CLI command to start the MCP on stdio.
+    |-
+    (config) => ({ command: 'node', args: ['build/index.js'], env: { CLICKUP_API_KEY: config.clickupApiKey, CLICKUP_TEAM_ID: config.clickupTeamId } })