list_tasks
Retrieve and filter tasks from Dart project management using assignee, status, priority, due date, and more criteria. Simplify task tracking and organization with customizable queries.
Instructions
List tasks from Dart with optional filtering parameters. You can filter by assignee, status, dartboard, priority, due date, and more.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignee | No | Filter by assignee name or email | |
| assigneeId | No | Filter by assignee ID | |
| dartboard | No | Filter by dartboard title | |
| dartboardId | No | Filter by dartboard ID | |
| description | No | Filter by description content | |
| dueAtAfter | No | Filter by due date after (ISO format) | |
| dueAtBefore | No | Filter by due date before (ISO format) | |
| ids | No | Filter by IDs | |
| inTrash | No | Filter by trash status | |
| isCompleted | No | Filter by completion status | |
| limit | No | Number of results per page | |
| offset | No | Initial index for pagination | |
| parentId | No | Filter by parent task ID | |
| priority | No | Filter by priority | |
| size | No | Filter by task size | |
| startAtAfter | No | Filter by start date after (ISO format) | |
| startAtBefore | No | Filter by start date before (ISO format) | |
| status | No | Filter by status | |
| statusId | No | Filter by status ID | |
| tag | No | Filter by tag | |
| tagId | No | Filter by tag ID | |
| title | No | Filter by title | |
| type | No | Filter by task type | |
| typeId | No | Filter by task type ID |
Implementation Reference
- index.ts:405-410 (handler)The handler for the "list_tasks" tool within the CallToolRequestSchema switch statement. It invokes TaskService.listTasks with the provided arguments and returns the tasks as a JSON string.
case LIST_TASKS_TOOL.name: { const tasks = await TaskService.listTasks(args); return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }], }; } - tools.ts:101-180 (schema)The tool schema definition for "list_tasks", including name, description, and detailed inputSchema for filtering parameters.
export const LIST_TASKS_TOOL: Tool = { name: "list_tasks", description: "List tasks from Dart with optional filtering parameters. You can filter by assignee, status, dartboard, priority, due date, and more.", inputSchema: { type: "object", properties: { assignee: { type: "string", description: "Filter by assignee name or email", }, assigneeId: { type: "string", description: "Filter by assignee ID", pattern: "^[a-zA-Z0-9]{12}$", }, dartboard: { type: "string", description: "Filter by dartboard title" }, dartboardId: { type: "string", description: "Filter by dartboard ID", pattern: "^[a-zA-Z0-9]{12}$", }, description: { type: "string", description: "Filter by description content", }, dueAtAfter: { type: "string", description: "Filter by due date after (ISO format)", }, dueAtBefore: { type: "string", description: "Filter by due date before (ISO format)", }, ids: { type: "string", description: "Filter by IDs" }, inTrash: { type: "boolean", description: "Filter by trash status" }, isCompleted: { type: "boolean", description: "Filter by completion status", }, limit: { type: "number", description: "Number of results per page" }, offset: { type: "number", description: "Initial index for pagination" }, parentId: { type: "string", description: "Filter by parent task ID", pattern: "^[a-zA-Z0-9]{12}$", }, priority: { type: "string", description: "Filter by priority" }, size: { type: "number", description: "Filter by task size" }, startAtAfter: { type: "string", description: "Filter by start date after (ISO format)", }, startAtBefore: { type: "string", description: "Filter by start date before (ISO format)", }, status: { type: "string", description: "Filter by status" }, statusId: { type: "string", description: "Filter by status ID", pattern: "^[a-zA-Z0-9]{12}$", }, tag: { type: "string", description: "Filter by tag" }, tagId: { type: "string", description: "Filter by tag ID", pattern: "^[a-zA-Z0-9]{12}$", }, title: { type: "string", description: "Filter by title" }, type: { type: "string", description: "Filter by task type" }, typeId: { type: "string", description: "Filter by task type ID", pattern: "^[a-zA-Z0-9]{12}$", }, }, required: [], }, }; - index.ts:192-214 (registration)Registration of the "list_tasks" tool (as LIST_TASKS_TOOL) in the TOOLS array, which is returned by the ListToolsRequest 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, ];