list_task_comments
Retrieve and filter task comments in Dart by task ID, author, text, dates, or other parameters for efficient project management and analysis.
Instructions
List comments from Dart with optional filtering parameters. You can filter by author, task, text content, dates, and more.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| author | No | Filter by author name or email | |
| authorId | No | Filter by author ID | |
| ids | No | Filter by comment IDs | |
| limit | No | Number of results per page | |
| offset | No | Initial index for pagination | |
| parentId | No | Filter by parent comment ID | |
| publishedAtAfter | No | Filter by published date after (ISO format) | |
| publishedAtBefore | No | Filter by published date before (ISO format) | |
| task | No | Filter by task title | |
| taskId | Yes | Filter by task ID | |
| text | No | Filter by comment text content |
Implementation Reference
- index.ts:485-491 (handler)Handler logic for the 'list_task_comments' tool. Validates the taskId and calls CommentService.listComments with the provided arguments, returning the JSON-stringified comments.
case LIST_TASK_COMMENTS_TOOL.name: { const taskId = getIdValidated(args.taskId, "taskId"); const comments = await CommentService.listComments({ taskId, ...args }); return { content: [{ type: "text", text: JSON.stringify(comments, null, 2) }], }; } - tools.ts:391-445 (schema)Tool definition including name, description, and detailed inputSchema for 'list_task_comments' with properties for filtering comments by taskId (required), author, dates, etc.
export const LIST_TASK_COMMENTS_TOOL: Tool = { name: "list_task_comments", description: "List comments from Dart with optional filtering parameters. You can filter by author, task, text content, dates, and more.", inputSchema: { type: "object", properties: { taskId: { type: "string", description: "Filter by task ID", }, author: { type: "string", description: "Filter by author name or email", }, authorId: { type: "string", description: "Filter by author ID", }, ids: { type: "string", description: "Filter by comment IDs", }, limit: { type: "number", description: "Number of results per page", }, offset: { type: "number", description: "Initial index for pagination", }, parentId: { type: "string", description: "Filter by parent comment ID", }, publishedAtAfter: { type: "string", description: "Filter by published date after (ISO format)", }, publishedAtBefore: { type: "string", description: "Filter by published date before (ISO format)", }, task: { type: "string", description: "Filter by task title", }, text: { type: "string", description: "Filter by comment text content", }, }, required: ["taskId"], }, }; - index.ts:192-214 (registration)Registration of all tools including LIST_TASK_COMMENTS_TOOL in the TOOLS array, which is returned by ListToolsRequestSchema handler.
const TOOLS = [ // Config GET_CONFIG_TOOL, // Tasks CREATE_TASK_TOOL, LIST_TASKS_TOOL, GET_TASK_TOOL, UPDATE_TASK_TOOL, DELETE_TASK_TOOL, // Docs CREATE_DOC_TOOL, LIST_DOCS_TOOL, GET_DOC_TOOL, UPDATE_DOC_TOOL, DELETE_DOC_TOOL, // Comments ADD_TASK_COMMENT_TOOL, LIST_TASK_COMMENTS_TOOL, // Other GET_DARTBOARD_TOOL, GET_FOLDER_TOOL, GET_VIEW_TOOL, ]; - index.ts:371-373 (registration)Server request handler for listing tools, which exposes the registered TOOLS including 'list_task_comments'.
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS, }));