@griffinwork40/clickup-mcp-server 1.1.3 → 1.1.5

package/dist/tools/tasks-write.js

@@ -0,0 +1,232 @@
+/**
+ * Task write tools for ClickUp MCP server.
+ * Tools for creating, updating, and deleting tasks.
+ */
+import { z } from "zod";
+import { ResponseFormat, Priority } from "../constants.js";
+import { ResponseFormatSchema } from "../schemas.js";
+import { makeApiRequest, handleApiError, formatTaskMarkdown } from "../utils/index.js";
+/**
+ * Register task write tools with the MCP server
+ */
+export function registerTaskWriteTools(server) {
+    // Tool 8: Create Task
+    server.registerTool("clickup_create_task", {
+        title: "Create ClickUp Task",
+        description: `Create a new task in a list.
+
+Use clickup_get_list_details first to see available statuses.
+
+Args:
+  - list_id (string): The list ID where task will be created
+  - name (string): Task name (required)
+  - description (string, optional): Task description (supports markdown)
+  - status (string, optional): Task status (must match list statuses)
+  - priority (1-4, optional): Priority (1=Urgent, 2=High, 3=Normal, 4=Low)
+  - assignees (number[], optional): Array of assignee user IDs
+  - due_date (number, optional): Due date as Unix timestamp in milliseconds
+  - start_date (number, optional): Start date as Unix timestamp in milliseconds
+  - tags (string[], optional): Array of tag names
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  The created task with all properties including the new task ID.
+
+Examples:
+  - Use when: "Create a task called 'Fix bug' in list 123456"
+  - Use when: "Add a new task with priority high and assign to user 789"
+
+Error Handling:
+  - Returns "Error: Bad request" if status doesn't match list statuses (400)
+  - Returns "Error: Resource not found" if list_id is invalid (404)`,
+        inputSchema: z.object({
+            list_id: z.string().min(1).describe("List ID"),
+            name: z.string().min(1).max(1000).describe("Task name"),
+            description: z.string().optional().describe("Task description (markdown supported)"),
+            status: z.string().optional().describe("Task status (must match list statuses)"),
+            priority: z.nativeEnum(Priority).optional().describe("Priority: 1=Urgent, 2=High, 3=Normal, 4=Low"),
+            assignees: z.array(z.number()).optional().describe("Assignee user IDs"),
+            due_date: z.number().optional().describe("Due date (Unix timestamp in milliseconds)"),
+            start_date: z.number().optional().describe("Start date (Unix timestamp in milliseconds)"),
+            tags: z.array(z.string()).optional().describe("Tag names"),
+            response_format: ResponseFormatSchema
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const taskData = {
+                name: params.name
+            };
+            if (params.description)
+                taskData.description = params.description;
+            if (params.status)
+                taskData.status = params.status;
+            if (params.priority)
+                taskData.priority = params.priority;
+            if (params.assignees)
+                taskData.assignees = params.assignees;
+            if (params.due_date)
+                taskData.due_date = params.due_date;
+            if (params.start_date)
+                taskData.start_date = params.start_date;
+            if (params.tags)
+                taskData.tags = params.tags;
+            const task = await makeApiRequest(`list/${params.list_id}/task`, "POST", taskData);
+            let result;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = ["# Task Created Successfully", ""];
+                lines.push(formatTaskMarkdown(task));
+                result = lines.join("\n");
+            }
+            else {
+                result = JSON.stringify(task, null, 2);
+            }
+            return {
+                content: [{ type: "text", text: result }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+    // Tool 9: Update Task
+    server.registerTool("clickup_update_task", {
+        title: "Update ClickUp Task",
+        description: `Update an existing task's properties.
+
+Only include the fields you want to change.
+
+Args:
+  - task_id (string): The task ID
+  - name (string, optional): New task name
+  - description (string, optional): New description
+  - status (string, optional): New status
+  - priority (1-4, optional): New priority
+  - assignees_add (number[], optional): User IDs to add as assignees
+  - assignees_rem (number[], optional): User IDs to remove from assignees
+  - due_date (number, optional): New due date (Unix timestamp in milliseconds)
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  The updated task with all properties.
+
+Examples:
+  - Use when: "Update task abc123 status to 'complete'"
+  - Use when: "Change task priority to urgent and add assignee 789"
+
+Error Handling:
+  - Returns "Error: Resource not found" if task_id is invalid (404)
+  - Returns "Error: Bad request" if status doesn't exist in list (400)`,
+        inputSchema: z.object({
+            task_id: z.string().min(1).describe("Task ID"),
+            name: z.string().optional().describe("New task name"),
+            description: z.string().optional().describe("New description"),
+            status: z.string().optional().describe("New status"),
+            priority: z.nativeEnum(Priority).optional().describe("New priority"),
+            assignees_add: z.array(z.number()).optional().describe("User IDs to add as assignees"),
+            assignees_rem: z.array(z.number()).optional().describe("User IDs to remove"),
+            due_date: z.number().optional().describe("New due date (Unix timestamp)"),
+            response_format: ResponseFormatSchema
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const updateData = {};
+            if (params.name)
+                updateData.name = params.name;
+            if (params.description !== undefined)
+                updateData.description = params.description;
+            if (params.status)
+                updateData.status = params.status;
+            if (params.priority)
+                updateData.priority = params.priority;
+            if (params.due_date !== undefined)
+                updateData.due_date = params.due_date;
+            // Handle assignee updates separately
+            if (params.assignees_add && params.assignees_add.length > 0) {
+                updateData.assignees = { add: params.assignees_add };
+            }
+            if (params.assignees_rem && params.assignees_rem.length > 0) {
+                if (!updateData.assignees)
+                    updateData.assignees = {};
+                updateData.assignees.rem = params.assignees_rem;
+            }
+            const task = await makeApiRequest(`task/${params.task_id}`, "PUT", updateData);
+            let result;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = ["# Task Updated Successfully", ""];
+                lines.push(formatTaskMarkdown(task));
+                result = lines.join("\n");
+            }
+            else {
+                result = JSON.stringify(task, null, 2);
+            }
+            return {
+                content: [{ type: "text", text: result }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+    // Tool 10: Delete Task
+    server.registerTool("clickup_delete_task", {
+        title: "Delete ClickUp Task",
+        description: `Delete a task permanently.
+
+WARNING: This action is destructive and cannot be undone.
+
+Args:
+  - task_id (string): The task ID to delete
+
+Returns:
+  Confirmation message of deletion.
+
+Examples:
+  - Use when: "Delete task abc123"
+  - Don't use when: You want to archive (use update status to 'closed' instead)
+
+Error Handling:
+  - Returns "Error: Resource not found" if task_id is invalid (404)
+  - Returns "Error: Permission denied" if no delete access (403)`,
+        inputSchema: z.object({
+            task_id: z.string().min(1).describe("Task ID to delete")
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            await makeApiRequest(`task/${params.task_id}`, "DELETE");
+            return {
+                content: [{
+                        type: "text",
+                        text: `Task ${params.task_id} has been deleted successfully.`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=tasks-write.js.map

package/dist/tools/tasks-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-write.js","sourceRoot":"","sources":["../../src/tools/tasks-write.ts"],"names":[],"mappings":"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"}

package/dist/tools/time-tracking.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Time tracking tools for ClickUp MCP server.
+ * Tools for managing time entries.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register time tracking tools with the MCP server
+ */
+export declare function registerTimeTrackingTools(server: McpServer): void;
+//# sourceMappingURL=time-tracking.d.ts.map

package/dist/tools/time-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.d.ts","sourceRoot":"","sources":["../../src/tools/time-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmMjE"}

package/dist/tools/time-tracking.js

@@ -0,0 +1,180 @@
+/**
+ * Time tracking tools for ClickUp MCP server.
+ * Tools for managing time entries.
+ */
+import { z } from "zod";
+import { ResponseFormat } from "../constants.js";
+import { ResponseFormatSchema } from "../schemas.js";
+import { makeApiRequest, handleApiError, formatTimeEntryMarkdown, truncateResponse, formatTruncationInfo } from "../utils/index.js";
+/**
+ * Register time tracking tools with the MCP server
+ */
+export function registerTimeTrackingTools(server) {
+    // Tool 17: Start Time Entry
+    server.registerTool("clickup_start_time_entry", {
+        title: "Start Time Tracking",
+        description: `Start tracking time on a task.
+
+Args:
+  - team_id (string): The team ID
+  - task_id (string): The task ID to track time for
+  - description (string, optional): Description of what you're working on
+
+Returns:
+  The started time entry with start time and ID.
+
+Examples:
+  - Use when: "Start tracking time on task abc123"
+  - Use when: "Begin time entry for this task"
+
+Error Handling:
+  - Returns error if already tracking time
+  - Returns "Error: Resource not found" if task_id is invalid (404)`,
+        inputSchema: z.object({
+            team_id: z.string().min(1).describe("Team ID"),
+            task_id: z.string().min(1).describe("Task ID"),
+            description: z.string().optional().describe("Description of work")
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const data = { tid: params.task_id };
+            if (params.description)
+                data.description = params.description;
+            const entry = await makeApiRequest(`team/${params.team_id}/time_entries/start`, "POST", data);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Time tracking started successfully\n\n${formatTimeEntryMarkdown(entry.data)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+    // Tool 18: Stop Time Entry
+    server.registerTool("clickup_stop_time_entry", {
+        title: "Stop Time Tracking",
+        description: `Stop the currently running time entry.
+
+Args:
+  - team_id (string): The team ID
+
+Returns:
+  The completed time entry with duration.
+
+Examples:
+  - Use when: "Stop tracking time"
+  - Use when: "End current time entry"
+
+Error Handling:
+  - Returns error if no active time tracking
+  - Returns "Error: Resource not found" if team_id is invalid (404)`,
+        inputSchema: z.object({
+            team_id: z.string().min(1).describe("Team ID")
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const entry = await makeApiRequest(`team/${params.team_id}/time_entries/stop`, "POST");
+            return {
+                content: [{
+                        type: "text",
+                        text: `Time tracking stopped successfully\n\n${formatTimeEntryMarkdown(entry.data)}`
+                    }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+    // Tool 19: Get Time Entries
+    server.registerTool("clickup_get_time_entries", {
+        title: "Get Time Entries",
+        description: `Get time tracking entries for a team.
+
+Args:
+  - team_id (string): The team ID
+  - assignee (number, optional): Filter by assignee user ID
+  - start_date (number, optional): Filter entries after this date (Unix timestamp)
+  - end_date (number, optional): Filter entries before this date (Unix timestamp)
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  List of time entries with task, user, duration, and dates.
+
+Examples:
+  - Use when: "Show me time entries for team 123456"
+  - Use when: "Get time tracked by user 789 this week"
+
+Error Handling:
+  - Returns "Error: Resource not found" if team_id is invalid (404)`,
+        inputSchema: z.object({
+            team_id: z.string().min(1).describe("Team ID"),
+            assignee: z.number().optional().describe("Filter by assignee user ID"),
+            start_date: z.number().optional().describe("Filter after date (Unix timestamp)"),
+            end_date: z.number().optional().describe("Filter before date (Unix timestamp)"),
+            response_format: ResponseFormatSchema
+        }).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        try {
+            const queryParams = {};
+            if (params.assignee)
+                queryParams.assignee = params.assignee;
+            if (params.start_date)
+                queryParams.start_date = params.start_date;
+            if (params.end_date)
+                queryParams.end_date = params.end_date;
+            const data = await makeApiRequest(`team/${params.team_id}/time_entries`, "GET", undefined, queryParams);
+            const entries = data.data || [];
+            let result;
+            if (params.response_format === ResponseFormat.MARKDOWN) {
+                const lines = [`# Time Entries for Team ${params.team_id}`, ""];
+                lines.push(`Found ${entries.length} time entr${entries.length === 1 ? "y" : "ies"}`, "");
+                lines.push("");
+                for (const entry of entries) {
+                    lines.push(formatTimeEntryMarkdown(entry));
+                    lines.push("");
+                    lines.push("---");
+                    lines.push("");
+                }
+                result = lines.join("\n");
+            }
+            else {
+                result = JSON.stringify({ entries }, null, 2);
+            }
+            const { content: finalContent, truncation } = truncateResponse(result, entries.length, "entries");
+            result = finalContent + formatTruncationInfo(truncation);
+            return {
+                content: [{ type: "text", text: result }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: handleApiError(error) }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=time-tracking.js.map

package/dist/tools/time-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-tracking.js","sourceRoot":"","sources":["../../src/tools/time-tracking.ts"],"names":[],"mappings":"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"}

package/dist/utils/api-client.d.ts

@@ -0,0 +1,17 @@
+/**
+ * API client utilities for ClickUp MCP server.
+ * Handles authentication and HTTP requests to the ClickUp API.
+ */
+/**
+ * Get ClickUp API token from environment
+ */
+export declare function getApiToken(): string;
+/**
+ * Make an authenticated request to the ClickUp API
+ */
+export declare function makeApiRequest<T>(endpoint: string, method?: "GET" | "POST" | "PUT" | "DELETE", data?: any, params?: any): Promise<T>;
+/**
+ * Convert API errors to user-friendly messages
+ */
+export declare function handleApiError(error: unknown): string;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/utils/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAgB,EACjD,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,GACX,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgCrD"}

package/dist/utils/api-client.js

@@ -0,0 +1,77 @@
+/**
+ * API client utilities for ClickUp MCP server.
+ * Handles authentication and HTTP requests to the ClickUp API.
+ */
+import axios, { AxiosError } from "axios";
+import { API_BASE_URL, DEFAULT_TIMEOUT } from "../constants.js";
+/**
+ * Get ClickUp API token from environment
+ */
+export function getApiToken() {
+    const token = process.env.CLICKUP_API_TOKEN;
+    if (!token) {
+        throw new Error("CLICKUP_API_TOKEN environment variable is required");
+    }
+    return token;
+}
+/**
+ * Make an authenticated request to the ClickUp API
+ */
+export async function makeApiRequest(endpoint, method = "GET", data, params) {
+    try {
+        const token = getApiToken();
+        const response = await axios({
+            method,
+            url: `${API_BASE_URL}/${endpoint}`,
+            data,
+            params,
+            timeout: DEFAULT_TIMEOUT,
+            headers: {
+                "Authorization": token,
+                "Content-Type": "application/json",
+                "Accept": "application/json"
+            }
+        });
+        return response.data;
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Convert API errors to user-friendly messages
+ */
+export function handleApiError(error) {
+    if (error instanceof AxiosError) {
+        if (error.response) {
+            const status = error.response.status;
+            const data = error.response.data;
+            switch (status) {
+                case 400:
+                    return `Error: Bad request. ${data?.err || "Check your parameters and try again."}`;
+                case 401:
+                    return "Error: Invalid or missing API token. Please check your CLICKUP_API_TOKEN environment variable.";
+                case 403:
+                    return "Error: Permission denied. You don't have access to this resource.";
+                case 404:
+                    return `Error: Resource not found. ${data?.err || "Please check the ID is correct."}`;
+                case 429:
+                    return "Error: Rate limit exceeded. Please wait before making more requests. ClickUp allows 100 requests/minute (Business) or 1000/minute (Business Plus+).";
+                case 500:
+                case 502:
+                case 503:
+                    return "Error: ClickUp server error. Please try again later or check https://status.clickup.com";
+                default:
+                    return `Error: API request failed with status ${status}. ${data?.err || ""}`;
+            }
+        }
+        else if (error.code === "ECONNABORTED") {
+            return "Error: Request timed out. Please try again.";
+        }
+        else if (error.code === "ENOTFOUND" || error.code === "ECONNREFUSED") {
+            return "Error: Cannot connect to ClickUp API. Please check your internet connection.";
+        }
+    }
+    return `Error: Unexpected error occurred: ${error instanceof Error ? error.message : String(error)}`;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/utils/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,SAA4C,KAAK,EACjD,IAAU,EACV,MAAY;IAEZ,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;YAC3B,MAAM;YACN,GAAG,EAAE,GAAG,YAAY,IAAI,QAAQ,EAAE;YAClC,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE;gBACP,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,kBAAkB;gBAClC,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAEjC,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,GAAG;oBACN,OAAO,uBAAuB,IAAI,EAAE,GAAG,IAAI,sCAAsC,EAAE,CAAC;gBACtF,KAAK,GAAG;oBACN,OAAO,gGAAgG,CAAC;gBAC1G,KAAK,GAAG;oBACN,OAAO,mEAAmE,CAAC;gBAC7E,KAAK,GAAG;oBACN,OAAO,8BAA8B,IAAI,EAAE,GAAG,IAAI,iCAAiC,EAAE,CAAC;gBACxF,KAAK,GAAG;oBACN,OAAO,qJAAqJ,CAAC;gBAC/J,KAAK,GAAG,CAAC;gBACT,KAAK,GAAG,CAAC;gBACT,KAAK,GAAG;oBACN,OAAO,yFAAyF,CAAC;gBACnG;oBACE,OAAO,yCAAyC,MAAM,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACjF,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACzC,OAAO,6CAA6C,CAAC;QACvD,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACvE,OAAO,8EAA8E,CAAC;QACxF,CAAC;IACH,CAAC;IAED,OAAO,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACvG,CAAC"}

package/dist/utils/csv-export.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CSV export utilities for ClickUp MCP server.
+ * Export tasks to CSV format with custom field support.
+ */
+import type { ClickUpTask } from "../types.js";
+/**
+ * Options for exporting tasks to CSV
+ */
+export interface ExportCSVOptions {
+    archived?: boolean;
+    include_closed?: boolean;
+    statuses?: string[];
+    custom_fields?: string[];
+    include_standard_fields?: boolean;
+    add_phone_number_column?: boolean;
+}
+/**
+ * Escape CSV fields to handle commas, quotes, and newlines
+ */
+export declare function escapeCSV(value: any): string;
+/**
+ * Convert task to CSV row array
+ */
+export declare function taskToCSVRow(task: ClickUpTask, fieldOrder: string[]): string[];
+/**
+ * Export tasks to CSV format
+ */
+export declare function exportTasksToCSV(listId: string, options?: ExportCSVOptions): Promise<string>;
+//# sourceMappingURL=csv-export.d.ts.map

package/dist/utils/csv-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-export.d.ts","sourceRoot":"","sources":["../../src/utils/csv-export.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAQ5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAuE9E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CA4HjB"}