@pripanggalih/clickup-mcp 1.6.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Marco Pfeiffer
+Copyright (c) 2026 MW Pripanggalih
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+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.

package/README.md

@@ -0,0 +1,295 @@
+# ClickUp MCP by MW Pripanggalih
+
+Model Context Protocol (MCP) server for working with ClickUp workspaces from AI assistants. It supports rich task context, project search, task creation and updates, comments, documents, time tracking, and non-destructive workspace administration tools for Spaces, Folders, and Lists.
+
+This project is maintained as an independent ClickUp MCP distribution by MW Pripanggalih. It uses ClickUp API keys and is designed for local automation, coding assistants, and personal/team workflows that need direct ClickUp API access.
+
+## What You Can Do
+
+Turn natural language into powerful ClickUp actions:
+
+**Agentic Coding & Development:**
+- *"Look at CU-abc123, can you find the relevant code?"*
+- *"Can you build the dashboard like described in https://app.clickup.com/t/12a23b45c?"*
+- *"Check task CU-xyz789 and fix the bugs mentioned in the comments"*
+- *"Implement the API endpoints described in the integration task"*
+
+**Time Tracking & Productivity:**
+- *"Book 2 hours for the client meeting on the XYZ project"*
+- *"How much time did I spend on development tasks this week?"*
+- *"Log 30 minutes for code review on the authentication feature"*
+
+**Smart Search & Discovery:**
+- *"What task did I mention the CSV import in?"*
+- *"Find all tasks related to the payment gateway integration"*
+- *"Show me tasks where users reported login issues"*
+
+**Daily Workflow Management:**
+- *"What do I need to do today?"*
+- *"Create a task for fixing the dashboard bug in the frontend list"*
+- *"Update the API documentation task to 'in review' status"*
+- *"What tasks are blocking the mobile app release?"*
+
+**Rich Context & Collaboration:**
+- *"Show me all comments on the user authentication task"*
+- *"What's the latest update on the database migration?"*
+- *"Add a comment to the design task about the new wireframes"*
+
+**Document Management:**
+- *"Find documents about hiring in the Product space"*
+- *"Search for API documentation across all spaces"*
+- *"Read the API documentation in the development space"*
+- *"Create a new requirements document for the mobile app project"*
+- *"Update the meeting notes with today's decisions"*
+- *"What documents are in the product strategy space?"*
+
+**Workspace Administration (write mode):**
+- *"Create a new Space for the client migration project"*
+- *"Add a Folder called Roadmap to the Product space"*
+- *"Create a folderless List called Intake in the Operations space"*
+- *"Rename the Sprint Planning List to Delivery Planning"*
+
+## Key Features
+
+### 🔍 **Intelligent Search**
+- Fuzzy matching across task names, descriptions, and comments
+- Multi-language search support for international teams
+- Filter by assignees, projects, status, and metadata
+
+### 💬 **Complete Context**
+- Full comment histories and team discussions
+- Task descriptions with embedded images  
+- List descriptions and project guidelines
+- Document content with page navigation
+- Access to complete task history and decisions
+
+### ⏱️ **Time Tracking**
+- Log time entries with descriptions
+- View historical time logs and entries
+- Query time entries by task or date range
+
+### 📋 **Task & Document Management**
+- Create and update tasks with markdown descriptions
+- Create, read, and update documents and pages
+- Add comments and collaborate with team members
+- Manage priorities, due dates, assignees, and tags
+- Handle time estimates and custom field values
+
+### 🧭 **Workspace Administration**
+- Create and update Spaces, Folders, and Lists using official ClickUp API v2 endpoints
+- Create either folderless Lists in Spaces or Lists inside Folders
+- Keep destructive delete operations out of the default tool set
+- Treat List `status` as List color only, not task workflow status
+
+### 🔒 **Safety Features**
+- **Append-Only Descriptions**: Description fields are never overwritten - new content is safely appended with timestamps
+- **Normal Field Updates**: Status, priority, assignees, tags, and dates can be updated normally (easily revertible through ClickUp's history)
+
+## Installation
+
+### Prerequisites
+
+For all installation methods, you'll need:
+- Your `CLICKUP_API_KEY` (Profile Icon > Settings > Apps > API Token ~ usually starts with pk_)
+- Your `CLICKUP_TEAM_ID` (The 7–10 digit number in the URL when you are in the settings)
+
+### Option 1: MCPB Bundle (Recommended for Claude Desktop)
+
+Download the pre-built bundle from the [releases page](https://github.com/pripanggalih/clickup-mcp/releases). This method requires no Node.js installation.
+
+You'll get a configuration screen where you are prompted to enter your API key and team ID.
+
+### Option 2: NPX Installation
+
+This method automatically updates to the latest version and is preferred for users who want the newest features.
+
+**For Claude Desktop, Windsurf, Cursor and others:**
+
+Add the following to your MCP configuration file:
+
+```json
+{
+  "mcpServers": {
+    "clickup": {
+      "command": "npx",
+      "args": [
+        "@pripanggalih/clickup-mcp@latest"
+      ],
+      "env": {
+        "CLICKUP_API_KEY": "your_api_key",
+        "CLICKUP_TEAM_ID": "your_team_id"
+      }
+    }
+  }
+}
+```
+
+Replace `your_api_key` and `your_team_id` with your actual ClickUp credentials.
+
+**Where to add this configuration:**
+- **Claude Desktop**: Settings > Developer > Edit Config
+- **Windsurf**: Add to your MCP configuration file
+- **Cursor**: Configure through the MCP settings panel
+
+### Option 3: Coding Tools Integration
+
+**Claude Code (CLI):**
+```bash
+claude mcp add --scope user clickup \
+  --env CLICKUP_API_KEY=YOUR_KEY \
+  --env CLICKUP_TEAM_ID=YOUR_ID \
+  --env CLICKUP_MCP_MODE=read-minimal \
+  --env MAX_IMAGES=16 \
+  --env MAX_RESPONSE_SIZE_MB=4 \
+  -- npx -y @pripanggalih/clickup-mcp
+```
+
+> Claude Code can handle a lot of images, thus the recommended increased limits.
+ 
+> Note the `CLICKUP_MCP_MODE=read-minimal`. This is my usage recommendation, but feel free to use one of the other modes.
+
+**OpenAI Codex:**
+Add these lines to your `~/.codex/config.toml` file:
+```toml
+[mcp_servers.clickup]
+command = "npx"
+args = ["-y", "@pripanggalih/clickup-mcp@latest"]
+env = { "CLICKUP_API_KEY" = "YOUR_KEY", "CLICKUP_TEAM_ID" = "YOUR_ID", "CLICKUP_MCP_MODE" = "read-minimal" }
+```
+
+> Codex seems to not be able to handle images from MCP's. See [this issue](https://github.com/openai/codex/issues/3741) for more details.
+
+> Note the `CLICKUP_MCP_MODE=read-minimal`. This is my usage recommendation, but feel free to use one of the other modes.
+
+## MCP Modes & Available Tools
+
+The ClickUp MCP supports three operational modes to balance functionality, security, and performance:
+
+- **🚀 `read-minimal`**: Perfect for AI coding assistants and context gathering
+- **📖 `read`**: Full read-only access for project exploration and workflow understanding  
+- **✏️ `write`** (Default): Complete functionality for task management and productivity workflows
+
+| Tool                   | read-minimal | read | write | Description                                                                             |
+|------------------------|:------------:|:----:|:-----:|-----------------------------------------------------------------------------------------|
+| `getTaskById`          |      ✅       |  ✅   |   ✅   | Get complete task details including comments, images, and metadata                      |
+| `addComment`           |      ❌       |  ❌   |   ✅   | Add comments to tasks for collaboration                                                 |
+| `updateTask`           |      ❌       |  ❌   |   ✅   | Update tasks (status, priority, assignees, etc.) with **SAFE APPEND-ONLY** descriptions |
+| `createTask`           |      ❌       |  ❌   |   ✅   | Create new tasks with full markdown support                                             |
+| `searchTasks`          |      ✅       |  ✅   |   ✅   | Find tasks by content, keywords, assignees, or project context                          |
+| `searchSpaces`         |      ❌       |  ✅   |   ✅   | Browse workspace structure, project organization, and documents                         |
+| `getListInfo`          |      ❌       |  ✅   |   ✅   | Get list details and available statuses for task creation                               |
+| `updateListInfo`       |      ❌       |  ❌   |   ✅   | **SAFE APPEND-ONLY** updates to list descriptions (preserves existing content)          |
+| `createSpace`          |      ❌       |  ❌   |   ✅   | Create a new Space in the configured Workspace                                         |
+| `updateSpace`          |      ❌       |  ❌   |   ✅   | Update Space name, color, privacy, assignee, admin, and feature settings               |
+| `createFolder`         |      ❌       |  ❌   |   ✅   | Create a Folder inside a Space                                                         |
+| `updateFolder`         |      ❌       |  ❌   |   ✅   | Rename an existing Folder                                                              |
+| `createList`           |      ❌       |  ❌   |   ✅   | Create a folderless List in a Space or a List inside a Folder                          |
+| `updateList`           |      ❌       |  ❌   |   ✅   | Update List fields; `status_color` maps to ClickUp's List color, not task status       |
+| `getTimeEntries`       |      ❌       |  ✅   |   ✅   | View time entries and analyze time spent across projects                                |
+| `createTimeEntry`      |      ❌       |  ❌   |   ✅   | Log time entries for task tracking                                                      |
+| `readDocument`         |      ❌       |  ✅   |   ✅   | Get document details, page structure, and content with navigation                       |
+| `searchDocuments`      |      ❌       |  ✅   |   ✅   | Search documents by name and space with fuzzy matching and space filtering              |
+| `updateDocumentPage`   |      ❌       |  ❌   |   ✅   | Update existing page content or name with replace/append modes                          |
+| `createDocumentOrPage` |      ❌       |  ❌   |   ✅   | Create new documents with first page, or add pages/sub-pages to existing documents      |
+
+### Setting the Mode
+
+Add the mode to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "clickup": {
+      "command": "npx",
+      "args": ["-y", "@pripanggalih/clickup-mcp@latest"],
+      "env": {
+        "CLICKUP_API_KEY": "your_api_key",
+        "CLICKUP_TEAM_ID": "your_team_id",
+        "CLICKUP_MCP_MODE": "read"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+This MCP server can be configured using environment variables:
+
+- `CLICKUP_API_KEY`: (Required) Your ClickUp API key.
+- `CLICKUP_TEAM_ID`: (Required) Your ClickUp Team ID (formerly Workspace ID).
+- `CLICKUP_MCP_MODE`: (Optional) Controls which tools are available. Options: `read-minimal`, `read`, `write` (default).
+- `MAX_IMAGES`: (Optional) The maximum number of images to return for a task in `getTaskById`. Defaults to 4.
+- `MAX_RESPONSE_SIZE_MB`: (Optional) The maximum response size in megabytes for `getTaskById`. Uses intelligent size budgeting to fit the most important images within the limit. Defaults to 1.
+- `CLICKUP_PRIMARY_LANGUAGE`: (Optional) A hint for the primary language used in your ClickUp tasks (e.g., "de" for German, "en" for English). This helps the `searchTask` tool provide more tailored guidance in its description for multilingual searches.
+- `LANG`: (Optional) If `CLICKUP_PRIMARY_LANGUAGE` is not set, the MCP will check this standard environment variable (e.g., "en_US.UTF-8", "de_DE") as a fallback to infer the primary language.
+
+### Language-Aware Search Guidance
+
+The `searchTask` tool's description will dynamically adjust based on the detected primary language:
+- If `CLICKUP_PRIMARY_LANGUAGE` or `LANG` suggests a known primary language (e.g., German), the tool's description will specifically recommend providing search terms in both English and that detected language (e.g., German) for optimal results.
+- If no primary language is detected, a more general recommendation for multilingual workspaces will be provided.
+
+This feature aims to improve search effectiveness when the language of user queries (often English) differs from the language of the tasks in ClickUp, without making the MCP itself perform translations. The responsibility for providing bilingual search terms still lies with the agent calling the MCP, but the MCP offers more specific advice if it has a language hint.
+
+## Markdown Formatting Support
+
+Task descriptions and list documentation support full markdown formatting:
+
+### Examples
+
+**Task Creation with Markdown:**
+```
+Create a task called "API Integration" with description:
+# API Integration Requirements
+
+## Authentication
+- Implement OAuth 2.0 flow
+- Add JWT token validation
+- **Priority**: High security standards
+
+## Endpoints
+1. `/api/users` - User management
+2. `/api/data` - Data retrieval
+3. `/api/webhook` - Event notifications
+
+## Testing
+- [ ] Unit tests for auth flow
+- [ ] Integration tests
+- [ ] Load testing with 1000+ concurrent users
+
+> **Note**: This replaces the legacy REST implementation
+
+See related task: https://app.clickup.com/t/abc123
+```
+
+**Append-Only Updates (Safe):**
+When updating task descriptions, content is safely appended:
+```markdown
+[Existing task description content]
+
+---
+**Edit (2024-01-15):** Added new acceptance criteria based on client feedback:
+- Must support mobile responsive design
+- Performance requirement: < 2s load time
+```
+
+This ensures no existing content is ever lost while maintaining a clear audit trail.
+
+## Performance & Limitations
+
+**Optimized for AI Workflows:**
+- **Smart Image Processing**: Intelligent size budgeting prioritizes the most recent images while respecting both count (`MAX_IMAGES`, default: 4) and total response size limits (`MAX_RESPONSE_SIZE_MB`, default: 1MB)
+- **Search Scope**: Searches within the most recent 1000-3000 tasks to prevent running into rate limits (exact number varies by endpoint)
+- **Search Results**: Returns up to 50 most relevant matches to prevent flooding the agent with too many results
+
+**Current Scope:**
+- Focused on task-level operations rather than bulk workspace management
+- Optimized for conversational AI workflows rather than data migration
+- Designed for productivity enhancement, not administrative operations
+
+These limitations ensure reliable performance while covering the most common use cases for both development context and productivity management.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config"); // Load .env file
+const index_1 = require("./index");
+async function main() {
+    // Wait for server initialization to complete
+    const server = await index_1.serverPromise;
+    const args = process.argv.slice(2);
+    // Special command to show instructions
+    if (args.length === 1 && args[0] === 'instructions') {
+        console.log("Server Instructions:");
+        console.log(server.server._instructions || "No instructions configured");
+        process.exit(0);
+    }
+    // Special commands for testing resources
+    if (args.length === 1 && args[0] === 'resources') {
+        console.log("Listing available resources...");
+        try {
+            // @ts-ignore - Accessing private property for testing purposes
+            const resourceTemplates = server._registeredResourceTemplates;
+            if (resourceTemplates && Object.keys(resourceTemplates).length > 0) {
+                for (const [name, template] of Object.entries(resourceTemplates)) {
+                    console.log(`Resource template: ${name}`);
+                    // @ts-ignore - Access template properties
+                    const uriTemplate = template.resourceTemplate.uriTemplate;
+                    console.log(`  URI Template: ${uriTemplate}`);
+                    // Test the list callback if available
+                    // @ts-ignore - Access template properties
+                    if (template.resourceTemplate._callbacks.list) {
+                        try {
+                            // @ts-ignore - Call list callback
+                            const result = await template.resourceTemplate._callbacks.list();
+                            console.log(`  Resources found: ${result.resources.length}`);
+                            result.resources.slice(0, 3).forEach((res, idx) => {
+                                console.log(`    ${idx + 1}. ${res.name} (${res.uri})`);
+                            });
+                            if (result.resources.length > 3) {
+                                console.log(`    ... and ${result.resources.length - 3} more`);
+                            }
+                        }
+                        catch (error) {
+                            console.log(`  Error listing resources: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                        }
+                    }
+                    console.log("");
+                }
+            }
+            else {
+                console.log("No resource templates registered.");
+            }
+        }
+        catch (error) {
+            console.error("Error accessing resources:", error instanceof Error ? error.message : 'Unknown error');
+        }
+        process.exit(0);
+    }
+    // Special command to read a specific resource
+    if (args.length === 2 && args[0] === 'resource') {
+        const resourceUri = args[1];
+        console.log(`Reading resource: ${resourceUri}`);
+        try {
+            // @ts-ignore - Accessing private property for testing purposes
+            const resourceTemplates = server._registeredResourceTemplates;
+            // Find matching template and call read callback
+            for (const [name, template] of Object.entries(resourceTemplates)) {
+                try {
+                    // @ts-ignore - Access template properties
+                    const result = await template.readCallback(new URL(resourceUri), {}, {});
+                    console.dir(result, { depth: null });
+                    process.exit(0);
+                }
+                catch (error) {
+                    // Continue to next template if this one doesn't match
+                    continue;
+                }
+            }
+            console.error("No matching resource template found for URI:", resourceUri);
+            process.exit(1);
+        }
+        catch (error) {
+            console.error("Error reading resource:", error instanceof Error ? error.message : 'Unknown error');
+            process.exit(1);
+        }
+    }
+    if (args.length < 1) {
+        console.error("Usage: npm run cli <tool-name> [param1=value1 param2=value2 ...]");
+        console.error("       npm run cli instructions");
+        console.error("       npm run cli resources");
+        console.error("       npm run cli resource <uri>");
+        console.error("\nAvailable tools:");
+        // @ts-ignore - Accessing private property for testing purposes
+        const tools = server._registeredTools;
+        if (tools) {
+            for (const [name, tool] of Object.entries(tools)) {
+                console.error(`  - ${name}: ${tool.description}`);
+                if (tool.inputSchema && tool.inputSchema._def && typeof tool.inputSchema._def.shape === 'function') {
+                    console.error("    Parameters:");
+                    const shape = tool.inputSchema._def.shape();
+                    for (const [paramName, schema] of Object.entries(shape)) {
+                        // @ts-ignore - Accessing schema description
+                        const description = schema.description || "No description";
+                        console.error(`      - ${paramName}: ${description}`);
+                    }
+                }
+                else {
+                    console.error("    Parameters: None");
+                }
+                console.error("");
+            }
+        }
+        process.exit(1);
+    }
+    const toolName = args[0];
+    const params = {};
+    // Parse parameters
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        const match = arg.match(/^([^=]+)=(.*)$/);
+        if (match) {
+            const [, key, value] = match;
+            // Try to parse as JSON if it looks like a JSON value
+            try {
+                if (value.startsWith('{') || value.startsWith('[') ||
+                    value === 'true' || value === 'false' ||
+                    (value.startsWith('"') && value.endsWith('"')) ||
+                    (!isNaN(Number(value)) && !key.includes('id') && !value.startsWith('"'))) {
+                    params[key] = JSON.parse(value);
+                }
+                else {
+                    params[key] = value;
+                }
+            }
+            catch (e) {
+                params[key] = value;
+            }
+        }
+    }
+    try {
+        // @ts-ignore - Accessing private property for testing purposes
+        const tools = server._registeredTools;
+        if (!tools || !tools[toolName]) {
+            console.error(`Unknown tool: ${toolName}`);
+            process.exit(1);
+        }
+        const tool = tools[toolName];
+        // Validate parameters using the tool's schema, if it exists
+        if (tool.inputSchema) {
+            try {
+                tool.inputSchema.parse(params);
+            }
+            catch (error) {
+                const validationError = error;
+                console.error("Parameter validation error:", validationError.message);
+                process.exit(1);
+            }
+        }
+        else if (Object.keys(params).length > 0) {
+            // If there's no schema, but parameters were provided, it's an error
+            console.error(`Error: Tool '${toolName}' does not accept any parameters, but parameters were provided.`);
+            process.exit(1);
+        }
+        // Mock environment variables for testing if they're not set
+        if (!process.env.CLICKUP_API_KEY || !process.env.CLICKUP_TEAM_ID) {
+            console.warn("Warning: Using mock API credentials. This will not return real data.");
+            process.env.CLICKUP_API_KEY = process.env.CLICKUP_API_KEY || 'test_api_key';
+            process.env.CLICKUP_TEAM_ID = process.env.CLICKUP_TEAM_ID || 'test_team_id';
+        }
+        // Call the tool's callback function
+        const result = await tool.callback(params);
+        console.dir(result.content);
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error("Error:", error.message);
+        }
+        else {
+            console.error("Unknown error occurred");
+        }
+        process.exit(1);
+    }
+}
+main().catch(console.error);

package/dist/clickup-text.d.ts

@@ -0,0 +1,83 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types";
+import { ImageMetadataBlock } from "./shared/types";
+/**
+ * Represents a ClickUp text item which can be plain text or an image
+ */
+export interface ClickUpTextItem {
+    text?: string;
+    type?: string;
+    image?: {
+        id?: string;
+        name?: string;
+        title?: string;
+        type?: string;
+        extension?: string;
+        thumbnail_large?: string;
+        thumbnail_medium?: string;
+        thumbnail_small?: string;
+        url: string;
+        uploaded?: boolean;
+    };
+    attributes?: any;
+}
+/**
+ * Represents a ClickUp attachment
+ */
+export interface ClickUpAttachment {
+    thumbnail_large?: string;
+    thumbnail_medium?: string;
+    thumbnail_small?: string;
+    url: string;
+    [key: string]: any;
+}
+/**
+ * Process an array of ClickUp text items into a structured content format
+ * that includes both text and images in their original sequence
+ *
+ * @param textItems Array of text items from ClickUp API
+ * @returns Promise resolving to an array of content blocks (text and images)
+ */
+export declare function convertClickUpTextItemsToToolCallResult(textItems: ClickUpTextItem[]): Promise<(CallToolResult["content"][number] | ImageMetadataBlock)[]>;
+/**
+ * Splits markdown text at image references and converts them to image blocks
+ * @param markdownText The markdown text to process
+ * @param attachments Array of attachments from the Clickup API
+ * @returns Array of content blocks (text and images)
+ */
+export declare function convertMarkdownToToolCallResult(markdownText: string, attachments: ClickUpAttachment[] | null | undefined): (CallToolResult["content"][number] | ImageMetadataBlock)[];
+/**
+ * Represents a ClickUp comment block with formatting
+ */
+export interface ClickUpCommentBlock {
+    text?: string;
+    type?: string;
+    attributes?: {
+        bold?: boolean;
+        italic?: boolean;
+        code?: boolean;
+        link?: string;
+        'code-block'?: {
+            'code-block': string;
+        };
+        header?: number;
+        blockquote?: {};
+        'blockquote-size'?: 'large';
+        list?: {
+            list: 'bullet' | 'ordered' | 'unchecked' | 'checked';
+        };
+        indent?: number;
+        'block-id'?: string;
+    };
+    list?: {
+        list: 'bullet' | 'ordered' | 'unchecked' | 'checked';
+    };
+}
+/**
+ * Convert markdown text to ClickUp comment blocks format using remark
+ * Supports: headers, bold, italic, code, links, lists, blockquotes, code blocks
+ *
+ * @param markdown The markdown text to convert
+ * @returns Array of ClickUp comment blocks
+ */
+export declare function convertMarkdownToClickUpBlocks(markdown: string): ClickUpCommentBlock[];
+//# sourceMappingURL=clickup-text.d.ts.map

package/dist/clickup-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickup-text.d.ts","sourceRoot":"","sources":["../src/clickup-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA4BD;;;;;;GAMG;AACH,wBAAsB,uCAAuC,CAC3D,SAAS,EAAE,eAAe,EAAE,GAC3B,OAAO,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAsNrE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAClD,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CA0I5D;AA8BD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE;YACb,YAAY,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,EAAE,CAAC;QAChB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;SACtD,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;KACtD,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAoBtF"}