@taazkareem/clickup-mcp-server 0.2.2 → 0.2.4

package/README.md

@@ -12,7 +12,9 @@ Directions for use with Cursor Composer Agent:
 2. Go to Features in settings
 3. Add under MCP Servers:
 ```bash
-npx -y @taazkareem/clickup-mcp-server --env CLICKUP_API_KEY=your_api_key_here --env CLICKUP_TEAM_ID=your_team_id_here
+npx -y @taazkareem/clickup-mcp-server \
+  --env CLICKUP_API_KEY=your_api_key_here \
+  --env CLICKUP_TEAM_ID=your_team_id_here
 ```
 4. Replace the credentials and click Save
 5. Use Natural Language to interact with your ClickUp Workspace!
@@ -31,7 +33,7 @@ npx -y @taazkareem/clickup-mcp-server --env CLICKUP_API_KEY=your_api_key_here --
   - List and folder management in spaces
   - Smart caching to reduce API calls
   - Name/ID-based item lookup
-  - Optimized task organization
+
 
 - 🔄 **Smart Integration**
   - Case-insensitive name lookups
@@ -47,61 +49,30 @@ npx -y @taazkareem/clickup-mcp-server --env CLICKUP_API_KEY=your_api_key_here --
 
 ## Available Tools
 
-### Workspace Tools
-**get_workspace_hierarchy**
-Returns complete workspace structure (spaces, folders, lists). No parameters required.
-
-### Task Tools
-**get_tasks** `(listId|listName)`
-Get tasks from list with optional filters (archived, page, order_by, reverse, subtasks, statuses, include_closed, assignees, due_date_gt/lt, custom_fields).
-
-**get_task** `(taskId|taskName, ?listName)`
-Get detailed task info including attachments and custom fields.
-
-**create_task** `(listId|listName, taskName)`
-Create task with optional description (markdown), status, priority (1-4), dueDate.
-
-**create_bulk_tasks** `(listId|listName, tasks[])`
-Bulk create tasks with automatic rate limiting. Each task: name (required), description, status, priority, dueDate (optional).
-
-**update_task** `(taskId|taskName, ?listName)`
-Update task name, description, status, priority (1-4), dueDate.
-
-**delete_task** `(taskId|taskName, ?listName)`
-Permanently delete a task.
-
-**move_task** `(taskId|taskName, destinationListId|destinationListName, ?sourceListName)`
-Move task to different list, preserving task data.
-
-**duplicate_task** `(taskId|taskName, destinationListId|destinationListName, ?sourceListName)`
-Create copy of task in specified list.
-
-### List & Folder Tools
-**create_list** `(spaceId|spaceName, listName)`
-Create list with optional content, dueDate, priority (1-4), assignee.
-
-**create_folder** `(spaceId|spaceName, folderName, ?overrideStatuses)`
-Create folder in space.
-
-**create_list_in_folder** `(folderId|folderName, listName)`
-Create list in folder with optional content and status.
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| [get_workspace_hierarchy](docs/tools.md#workspace-organization) | Get complete workspace structure | None |
+| [get_tasks](docs/tools.md#task-management) | Retrieve tasks from a list | `listId` or `listName` |
+| [get_task](docs/tools.md#task-management) | Get single task details | `taskId` or `taskName` |
+| [create_task](docs/tools.md#task-management) | Create a new task | `listId`, `taskName` |
+| [create_bulk_tasks](docs/tools.md#task-management) | Create multiple tasks | `listId`, `tasks[]` |
+| [update_task](docs/tools.md#task-management) | Modify task properties | `taskId` or `taskName` |
+| [delete_task](docs/tools.md#task-management) | Remove a task | `taskId` or `taskName` |
+| [move_task](docs/tools.md#task-management) | Move task to another list | `taskId`, `destinationListId` |
+| [duplicate_task](docs/tools.md#task-management) | Copy task to another list | `taskId`, `destinationListId` |
+| [create_list](docs/tools.md#list-management) | Create a new list | `spaceId`, `listName` |
+| [create_folder](docs/tools.md#folder-management) | Create a new folder | `spaceId`, `folderName` |
+| [create_list_in_folder](docs/tools.md#list-management) | Create list in folder | `folderId`, `listName` |
+
+See [full documentation](docs/tools.md) for optional parameters and advanced usage.
 
 ## Available Prompts
 
-1. **summarize_tasks**
-   - Basic task summary by status
-   - Lists tasks with their current states
-   - Shows task relationships within lists
-
-2. **analyze_priorities**
-   - Reviews current task priorities
-   - Suggests priority adjustments
-   - Recommends task sequencing
-
-3. **generate_description**
-   - Interactive prompt for creating task descriptions
-   - Helps structure task information
-   - Includes objectives, criteria, and dependencies
+| Prompt | Purpose | Features |
+|--------|---------|----------|
+| [summarize_tasks](docs/tools.md#prompts) | Generate task overview | Status summary, relationships, current states |
+| [analyze_priorities](docs/tools.md#prompts) | Review task priorities | Priority review, adjustments, sequencing |
+| [generate_description](docs/tools.md#prompts) | Create task descriptions | Structure, objectives, dependencies |
 
 ## Error Handling
 
@@ -115,12 +86,9 @@ The server provides clear error messages for:
 
 ## Support the Developer
 
-If you find this project useful, please consider supporting the developer:
-Talib Kareem (taazkareem@icloud.com)
-
-[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-Support-orange)](https://www.buymeacoffee.com/taazkareem)
+If you find this project useful, please consider supporting
 
-<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="vertical-align: middle; margin-right: 4px;"><path d="M4 18h12l4-4h-12z" /><path d="M8 14l-4-4h12l4 4" /><path d="M16 10l4-4h-12l-4 4" /></svg><span style="vertical-align: middle;">**Solana Wallet:** `GjtRksihd7SWQw7hJSCDMcTxPHbgpNs7xPW3nFubNjVM`</span>
+[![Sponsor TaazKareem](https://img.shields.io/badge/Sponsor-TaazKareem-orange?logo=github)](https://github.com/sponsors/TaazKareem)
 
 ## Contributing
 

package/build/index.js

@@ -48,7 +48,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         tools: [
             {
                 name: "get_workspace_hierarchy",
-                description: "Get the complete hierarchy of spaces, folders, and lists in the workspace.  -First check chat history for space, folder, and list names or IDs.  If not found, use this tool to get necessary information.",
+                description: "Get the complete hierarchy of spaces, folders, and lists in the workspace.  Important: If looking up information, first check chat history for space, folder, and list names or ID matches.  If not found, use this tool to get necessary information.",
                 inputSchema: {
                     type: "object",
                     properties: {},
@@ -366,7 +366,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "get_tasks",
-                description: "Get tasks from a ClickUp list with optional filters. Supports direct name-based lookup for lists - no need to know the list ID. If the list doesn't exist, you can create it using create_list or create_list_in_folder.",
+                description: "Get tasks from a ClickUp list with optional filters. Supports direct name-based lookup for lists - no need to know the list ID. If the list doesn't exist, you can create it using create_list or create_list_in_folder. ",
                 inputSchema: {
                     type: "object",
                     properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taazkareem/clickup-mcp-server",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "ClickUp MCP Server - Integrate ClickUp tasks with AI through Model Context Protocol",
   "type": "module",
   "main": "build/index.js",