Enhanced Todoist MCP Server Extended

Instructions

Implementation Reference

• src/index.ts:1755-1781 (handler)

  The main handler function for the todoist_get_comments tool. Validates arguments with isCommentsArgs, calls todoistClient.getComments with taskId/projectId/cursor/limit, formats results using formatComment, and handles pagination and errors.

  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: any = {};
      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: any) {
      return { content: [{ type: "text", text: `Error getting comments: ${error.message}` }], isError: true };
    }
  }

• src/index.ts:631-655 (schema)

  Tool schema definition including name, description, and inputSchema for validating parameters like taskId/projectId (mutually exclusive), cursor, and limit.

  const GET_COMMENTS_TOOL: 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)"
        }
      }
    }
  };

• src/index.ts:1083-1121 (registration)

  Registration of the todoist_get_comments tool (as GET_COMMENTS_TOOL) in the list of available tools returned by ListToolsRequestSchema handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      // Task tools
      CREATE_TASK_TOOL,
      QUICK_ADD_TASK_TOOL,
      GET_TASKS_TOOL,
      GET_TASK_TOOL,
      UPDATE_TASK_TOOL,
      DELETE_TASK_TOOL,
      COMPLETE_TASK_TOOL,
      REOPEN_TASK_TOOL,
      SEARCH_TASKS_TOOL,
      MOVE_TASK_TOOL,
      BULK_MOVE_TASKS_TOOL,
      // Project tools
      GET_PROJECTS_TOOL,
      GET_PROJECT_TOOL,
      CREATE_PROJECT_TOOL,
      UPDATE_PROJECT_TOOL,
      DELETE_PROJECT_TOOL,
      // Section tools
      GET_SECTIONS_TOOL,
      CREATE_SECTION_TOOL,
      UPDATE_SECTION_TOOL,
      DELETE_SECTION_TOOL,
      // Label tools
      CREATE_LABEL_TOOL,
      GET_LABEL_TOOL,
      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,
    ],
  }));

• src/index.ts:1050-1066 (helper)

  Type guard function isCommentsArgs used in the handler to validate input arguments, ensuring exactly one of taskId or projectId is provided.

  function isCommentsArgs(args: unknown): args is {
    taskId?: string;
    projectId?: string;
    cursor?: string;
    limit?: number;
  } {
    if (typeof args !== "object" || args === null) {
      return false;
    }
    const { taskId, projectId } = args as any;
    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');
  }

• src/index.ts:732-742 (helper)

  Helper function formatComment used to format comment objects for output in the tool response.

  function formatComment(comment: any): string {
    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;
  }