@kydycode/todoist-mcp-server-ext 0.3.0 → 0.4.0

package/README.md

@@ -40,7 +40,13 @@ A comprehensive MCP (Model Context Protocol) server implementation that provides
 * **Label Customization**: Set names, colors, favorites, order.
 * **Paginated Label Listing**: Efficiently retrieve all labels.
 
-## 🛠️ Available Tools (Total 24)
+### 💬 **Comment Management (5 Tools)**
+* **Complete Comment CRUD**: Create, read, update, delete comments on tasks and projects.
+* **Attachment Support**: Add file attachments to comments with metadata.
+* **Flexible Targeting**: Comments can be attached to either tasks or projects.
+* **Paginated Comment Retrieval**: Efficiently browse through comment threads.
+
+## 🛠️ Available Tools (Total 29)
 
 ### Task Operations (10 tools)
 | Tool                      | Description                                                                         |
@@ -82,6 +88,15 @@ A comprehensive MCP (Model Context Protocol) server implementation that provides
 | `todoist_update_label`   | Update an existing label by its ID (name, color, favorite, order). |
 | `todoist_delete_label`   | Delete a label by its ID.                                          |
 
+### Comment Operations (5 tools)
+| Tool                       | Description                                                     |
+|----------------------------|-----------------------------------------------------------------|
+| `todoist_create_comment`   | Create a new comment on a task or project (with attachments).   |
+| `todoist_get_comment`      | Get a specific comment by its ID.                               |
+| `todoist_get_comments`     | Get comments for a task or project with pagination support.     |
+| `todoist_update_comment`   | Update an existing comment by its ID.                           |
+| `todoist_delete_comment`   | Delete a comment by its ID.                                     |
+
 ## 🚀 Installation & Setup
 
 ### Local Development Setup
@@ -166,13 +181,16 @@ npm install -g @kydycode/todoist-mcp-server-ext@latest
 "Search tasks: search: API deployment"
 ```
 
-### 🗂️ Project, Section, and Label Management
+### 🗂️ Project, Section, Label, and Comment Management
 ```
 "List all my projects"
 "Create project 'Q2 Planning' color:blue favorite:true view:board"
 "Get sections for project {project_id}"
 "Create label 'HighPriority' color:red isFavorite:true"
 "List all labels"
+"Add comment 'Great progress on this task!' to task {task_id}"
+"Get all comments for project {project_id}"
+"Update comment {comment_id} with new content"
 ```
 
 ## 🆚 Extended vs Original Comparison
@@ -187,6 +205,7 @@ npm install -g @kydycode/todoist-mcp-server-ext@latest
 | **Project Management**      | Limited                              | ✅ 5 Tools: Full CRUD operations, sub-projects, pagination |
 | **Section Management**      | Basic                                | ✅ 4 Tools: Complete section operations               |
 | **Label Management**        | Not Available                        | ✅ 5 Tools: Full CRUD operations, pagination          |
+| **Comment Management**      | Not Available                        | ✅ 5 Tools: Full CRUD operations, attachments, pagination |
 | **API Parameter Handling**  | Inconsistent                         | ✅ Proper parameter validation                          |
 | **Response Formatting**     | Basic                                | ✅ Enhanced readability, more details                 |
 | **Build System**            | Issues                               | ✅ Clean compilation                                  |

package/dist/index.js

@@ -546,6 +546,110 @@ const SEARCH_TASKS_TOOL = {
         required: ["query"]
     }
 };
+// Comment Management Tools
+const CREATE_COMMENT_TOOL = {
+    name: "todoist_create_comment",
+    description: "Create a new comment on a task or project",
+    inputSchema: {
+        type: "object",
+        properties: {
+            content: {
+                type: "string",
+                description: "The content/text of the comment"
+            },
+            taskId: {
+                type: "string",
+                description: "Task ID to add comment to (provide either taskId or projectId, not both)"
+            },
+            projectId: {
+                type: "string",
+                description: "Project ID to add comment to (provide either taskId or projectId, not both)"
+            },
+            attachment: {
+                type: "object",
+                description: "Optional file attachment (optional)",
+                properties: {
+                    fileName: { type: "string" },
+                    fileType: { type: "string" },
+                    fileUrl: { type: "string" },
+                    resourceType: { type: "string" }
+                }
+            }
+        },
+        required: ["content"]
+    }
+};
+const GET_COMMENT_TOOL = {
+    name: "todoist_get_comment",
+    description: "Get a specific comment by its ID",
+    inputSchema: {
+        type: "object",
+        properties: {
+            commentId: {
+                type: "string",
+                description: "The ID of the comment to retrieve"
+            }
+        },
+        required: ["commentId"]
+    }
+};
+const GET_COMMENTS_TOOL = {
+    name: "todoist_get_comments",
+    description: "Get comments for a task or project with pagination support",
+    inputSchema: {
+        type: "object",
+        properties: {
+            taskId: {
+                type: "string",
+                description: "Task ID to get comments for (provide either taskId or projectId, not both)"
+            },
+            projectId: {
+                type: "string",
+                description: "Project ID to get comments for (provide either taskId or projectId, not both)"
+            },
+            cursor: {
+                type: "string",
+                description: "Pagination cursor for next page (optional)"
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of comments to return (optional)"
+            }
+        }
+    }
+};
+const UPDATE_COMMENT_TOOL = {
+    name: "todoist_update_comment",
+    description: "Update an existing comment by its ID",
+    inputSchema: {
+        type: "object",
+        properties: {
+            commentId: {
+                type: "string",
+                description: "The ID of the comment to update"
+            },
+            content: {
+                type: "string",
+                description: "New content/text for the comment"
+            }
+        },
+        required: ["commentId", "content"]
+    }
+};
+const DELETE_COMMENT_TOOL = {
+    name: "todoist_delete_comment",
+    description: "Delete a comment by its ID",
+    inputSchema: {
+        type: "object",
+        properties: {
+            commentId: {
+                type: "string",
+                description: "The ID of the comment to delete"
+            }
+        },
+        required: ["commentId"]
+    }
+};
 // Server implementation
 const server = new Server({
     name: "todoist-mcp-server-enhanced",
@@ -590,6 +694,22 @@ function formatProject(project) {
 function formatLabel(label) {
     return `- ${label.name} (ID: ${label.id})${label.color ? `\n  Color: ${label.color}` : ''}${label.isFavorite ? `\n  Favorite: Yes` : ''}${label.order ? `\n  Order: ${label.order}` : ''}`;
 }
+// Helper function to format comment output
+function formatComment(comment) {
+    let commentDetails = `- ID: ${comment.id}\n  Content: ${comment.content}`;
+    if (comment.postedAt)
+        commentDetails += `\n  Posted At: ${comment.postedAt}`;
+    if (comment.taskId)
+        commentDetails += `\n  Task ID: ${comment.taskId}`;
+    if (comment.projectId)
+        commentDetails += `\n  Project ID: ${comment.projectId}`;
+    if (comment.attachment) {
+        commentDetails += `\n  Attachment: ${comment.attachment.fileName || 'File'} (${comment.attachment.fileType})`;
+        if (comment.attachment.fileUrl)
+            commentDetails += `\n  File URL: ${comment.attachment.fileUrl}`;
+    }
+    return commentDetails;
+}
 // Type guards for arguments
 function isCreateTaskArgs(args) {
     return (typeof args === "object" &&
@@ -720,6 +840,42 @@ function isUpdateLabelArgs(args) {
         "labelId" in args &&
         typeof args.labelId === "string");
 }
+function isCreateCommentArgs(args) {
+    if (typeof args !== "object" || args === null || !("content" in args) || typeof args.content !== "string") {
+        return false;
+    }
+    const { taskId, projectId } = args;
+    const targets = [taskId, projectId];
+    const providedTargets = targets.filter(target => target !== undefined && target !== null && String(target).trim() !== '');
+    // Exactly one target must be provided and be a non-empty string
+    return providedTargets.length === 1 &&
+        providedTargets.every(target => typeof target === 'string');
+}
+function isCommentIdArgs(args) {
+    return (typeof args === "object" &&
+        args !== null &&
+        "commentId" in args &&
+        typeof args.commentId === "string");
+}
+function isCommentsArgs(args) {
+    if (typeof args !== "object" || args === null) {
+        return false;
+    }
+    const { taskId, projectId } = args;
+    const targets = [taskId, projectId];
+    const providedTargets = targets.filter(target => target !== undefined && target !== null && String(target).trim() !== '');
+    // Exactly one target must be provided and be a non-empty string, or no targets (for all comments)
+    return providedTargets.length <= 1 &&
+        providedTargets.every(target => typeof target === 'string');
+}
+function isUpdateCommentArgs(args) {
+    return (typeof args === "object" &&
+        args !== null &&
+        "commentId" in args &&
+        "content" in args &&
+        typeof args.commentId === "string" &&
+        typeof args.content === "string");
+}
 // Tool handlers
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
@@ -752,6 +908,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         GET_LABELS_TOOL,
         UPDATE_LABEL_TOOL,
         DELETE_LABEL_TOOL,
+        // Comment tools
+        CREATE_COMMENT_TOOL,
+        GET_COMMENT_TOOL,
+        GET_COMMENTS_TOOL,
+        UPDATE_COMMENT_TOOL,
+        DELETE_COMMENT_TOOL,
     ],
 }));
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -1323,6 +1485,104 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 return { content: [{ type: "text", text: `Error in bulk moving tasks: ${error.message}` }], isError: true };
             }
         }
+        // Comment operations
+        if (name === "todoist_create_comment") {
+            if (!isCreateCommentArgs(args)) {
+                return { content: [{ type: "text", text: "Invalid arguments for create_comment" }], isError: true };
+            }
+            try {
+                const commentData = { content: args.content };
+                if (args.taskId)
+                    commentData.taskId = args.taskId;
+                if (args.projectId)
+                    commentData.projectId = args.projectId;
+                if (args.attachment)
+                    commentData.attachment = args.attachment;
+                const comment = await todoistClient.addComment(commentData);
+                return {
+                    content: [{ type: "text", text: `Comment created:\n${formatComment(comment)}` }],
+                    isError: false
+                };
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error creating comment: ${error.message}` }], isError: true };
+            }
+        }
+        if (name === "todoist_get_comment") {
+            if (!isCommentIdArgs(args)) {
+                return { content: [{ type: "text", text: "Invalid arguments for get_comment" }], isError: true };
+            }
+            try {
+                const comment = await todoistClient.getComment(args.commentId);
+                return {
+                    content: [{ type: "text", text: `Comment details:\n${formatComment(comment)}` }],
+                    isError: false
+                };
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error getting comment: ${error.message}` }], isError: true };
+            }
+        }
+        if (name === "todoist_get_comments") {
+            if (!isCommentsArgs(args)) {
+                return { content: [{ type: "text", text: "Invalid arguments for get_comments. Provide either taskId or projectId, not both." }], isError: true };
+            }
+            try {
+                const params = {};
+                if (args.taskId)
+                    params.taskId = args.taskId;
+                if (args.projectId)
+                    params.projectId = args.projectId;
+                if (args.cursor)
+                    params.cursor = args.cursor;
+                if (args.limit)
+                    params.limit = args.limit;
+                const commentsResponse = await todoistClient.getComments(params);
+                const commentList = commentsResponse.results?.map(formatComment).join('\n\n') || 'No comments found';
+                const nextCursor = commentsResponse.nextCursor ? `\n\nNext cursor for more comments: ${commentsResponse.nextCursor}` : '';
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Comments:\n${commentList}${nextCursor}`
+                        }],
+                    isError: false
+                };
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error getting comments: ${error.message}` }], isError: true };
+            }
+        }
+        if (name === "todoist_update_comment") {
+            if (!isUpdateCommentArgs(args)) {
+                return { content: [{ type: "text", text: "Invalid arguments for update_comment" }], isError: true };
+            }
+            try {
+                const { commentId, ...updateArgs } = args;
+                const updatedComment = await todoistClient.updateComment(commentId, updateArgs);
+                return {
+                    content: [{ type: "text", text: `Comment updated:\n${formatComment(updatedComment)}` }],
+                    isError: false
+                };
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error updating comment: ${error.message}` }], isError: true };
+            }
+        }
+        if (name === "todoist_delete_comment") {
+            if (!isCommentIdArgs(args)) {
+                return { content: [{ type: "text", text: "Invalid arguments for delete_comment" }], isError: true };
+            }
+            try {
+                await todoistClient.deleteComment(args.commentId);
+                return {
+                    content: [{ type: "text", text: `Comment ${args.commentId} deleted.` }],
+                    isError: false
+                };
+            }
+            catch (error) {
+                return { content: [{ type: "text", text: `Error deleting comment: ${error.message}` }], isError: true };
+            }
+        }
         return {
             content: [{ type: "text", text: `Unknown tool: ${name}` }],
             isError: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kydycode/todoist-mcp-server-ext",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Extended MCP server for Todoist API integration with enhanced features and improved compatibility",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",