Dooray MCP Server

Instructions

Implementation Reference

• src/tools/projects/get-task-list.ts:39-84 (handler)

  The main handler function that fetches tasks using projectsApi.getTasks with provided filters, applies response filtering, and returns JSON or error.

  export async function getTaskListHandler(args: GetTaskListInput) {
    try {
      const result = await projectsApi.getTasks({
        projectId: args.projectId,
        fromEmailAddress: args.fromEmailAddress,
        fromMemberIds: args.fromMemberIds,
        toMemberIds: args.toMemberIds,
        ccMemberIds: args.ccMemberIds,
        tagIds: args.tagIds,
        parentPostId: args.parentPostId,
        postNumber: args.postNumber,
        postWorkflowClasses: args.postWorkflowClasses,
        postWorkflowIds: args.postWorkflowIds,
        milestoneIds: args.milestoneIds,
        subjects: args.subjects,
        createdAt: args.createdAt,
        updatedAt: args.updatedAt,
        dueAt: args.dueAt,
        order: args.order,
        page: args.page,
        size: args.size,
      });
  
      // Filter to compact response to reduce token usage
      const compactResult = filterPaginatedResponse(result, filterTaskForList);
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(compactResult, null, 2),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error: ${formatError(error)}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/projects/get-task-list.ts:11-35 (schema)

  Zod schema used for input validation in the tool registry.

  export const getTaskListSchema = z.object({
    projectId: z.string().describe('Project ID (required)'),
    // Member filters
    fromEmailAddress: z.string().optional().describe('Filter by creator email address'),
    fromMemberIds: z.array(z.string()).optional().describe('Filter by creator member IDs (organizationMemberId)'),
    toMemberIds: z.array(z.string()).optional().describe('Filter by assignee member IDs (organizationMemberId)'),
    ccMemberIds: z.array(z.string()).optional().describe('Filter by CC member IDs (organizationMemberId)'),
    // Task filters
    tagIds: z.array(z.string()).optional().describe('Filter by tag IDs'),
    parentPostId: z.string().optional().describe('Filter by parent post ID (get subtasks)'),
    postNumber: z.number().optional().describe('Filter by specific task number'),
    postWorkflowClasses: z.array(z.string()).optional().describe('Filter by workflow classes: backlog, registered, working, closed'),
    postWorkflowIds: z.array(z.string()).optional().describe('Filter by workflow IDs defined in the project'),
    milestoneIds: z.array(z.string()).optional().describe('Filter by milestone IDs'),
    subjects: z.string().optional().describe('Filter by task subject (title)'),
    // Date filters (supports: today, thisweek, prev-Nd, next-Nd, or ISO8601 range like "2021-01-01T00:00:00+09:00~2021-01-10T00:00:00+09:00")
    createdAt: z.string().optional().describe('Filter by creation date (today, thisweek, prev-7d, next-7d, or ISO8601 range)'),
    updatedAt: z.string().optional().describe('Filter by update date (today, thisweek, prev-7d, next-7d, or ISO8601 range)'),
    dueAt: z.string().optional().describe('Filter by due date (today, thisweek, prev-7d, next-7d, or ISO8601 range)'),
    // Sorting
    order: z.string().optional().default('-postUpdatedAt').describe('Sort order: postDueAt, postUpdatedAt, createdAt (prefix with - for descending, e.g., -createdAt). Default: -postUpdatedAt (most recently updated first)'),
    // Pagination
    page: z.number().min(0).optional().describe('Page number (default: 0)'),
    size: z.number().min(1).max(100).optional().describe('Items per page (default: 20, max: 100)'),
  });

• src/tools/projects/get-task-list.ts:86-226 (schema)

  Tool specification object with name, detailed description, and JSON inputSchema used for tool listing.

  export const getTaskListTool = {
    name: 'get-task-list',
    description: `Get list of tasks in a Dooray project with powerful filtering and sorting.
  
  **IMPORTANT**: projectId is REQUIRED. This tool fetches tasks from a specific project.
  
  **Note**: Returns compact response with essential fields only. For complete task details, use get-task.
  
  **URL Pattern Recognition**:
  When given a Dooray URL like "https://nhnent.dooray.com/task/PROJECT_ID" or "https://nhnent.dooray.com/task/PROJECT_ID/TASK_ID", extract the PROJECT_ID (the first numeric ID after "/task/") and use it as the projectId parameter. When a URL is provided, use get-project for project info instead of get-project-list.
  
  **Member ID Filters** (use organizationMemberId from get-my-member-info):
  - toMemberIds: Tasks assigned to specific members
  - ccMemberIds: Tasks where members are in CC
  - fromMemberIds: Tasks created by specific members
  
  **Workflow Filters**:
  - postWorkflowClasses: ["backlog", "registered", "working", "closed"]
  - postWorkflowIds: Project-specific workflow IDs
  
  **Date Filters** (flexible patterns):
  - "today" - Today's tasks
  - "thisweek" - This week's tasks
  - "prev-7d" - Last 7 days
  - "next-7d" - Next 7 days
  - ISO8601 range: "2021-01-01T00:00:00+09:00~2021-01-10T00:00:00+09:00"
  
  **Examples**:
  1. All tasks in project:
     {"projectId": "123456"}
  
  2. Tasks assigned to me:
     {"projectId": "123456", "toMemberIds": ["my-org-member-id"]}
  
  3. Tasks in "working" status:
     {"projectId": "123456", "postWorkflowClasses": ["working"]}
  
  4. Tasks due today:
     {"projectId": "123456", "dueAt": "today"}
  
  5. Recent tasks (sorted by update time):
     {"projectId": "123456", "updatedAt": "prev-7d", "order": "-postUpdatedAt"}
  
  6. Tasks with specific milestone and tags:
     {"projectId": "123456", "milestoneIds": ["milestone123"], "tagIds": ["tag456"]}
  
  **Sorting**:
  - Default: Tasks are sorted by most recently updated first (-postUpdatedAt)
  - Custom: Use order parameter with: postDueAt, postUpdatedAt, createdAt
  - Prefix with - for descending (e.g., "-createdAt")
  
  Returns paginated task list with id, number, subject, status, priority, dueDate, assignees, tags, and milestone.`,
    inputSchema: {
      type: 'object',
      properties: {
        projectId: {
          type: 'string',
          description: 'Project ID (REQUIRED)',
        },
        fromEmailAddress: {
          type: 'string',
          description: 'Filter by creator email address',
        },
        fromMemberIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by creator member IDs',
        },
        toMemberIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by assignee member IDs (organizationMemberId)',
        },
        ccMemberIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by CC member IDs',
        },
        tagIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by tag IDs',
        },
        parentPostId: {
          type: 'string',
          description: 'Filter by parent post ID (get subtasks)',
        },
        postNumber: {
          type: 'number',
          description: 'Filter by specific task number',
        },
        postWorkflowClasses: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by workflow classes: backlog, registered, working, closed',
        },
        postWorkflowIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by workflow IDs',
        },
        milestoneIds: {
          type: 'array',
          items: { type: 'string' },
          description: 'Filter by milestone IDs',
        },
        subjects: {
          type: 'string',
          description: 'Filter by task subject',
        },
        createdAt: {
          type: 'string',
          description: 'Filter by creation date (today, thisweek, prev-7d, next-7d, or ISO8601 range)',
        },
        updatedAt: {
          type: 'string',
          description: 'Filter by update date (today, thisweek, prev-7d, next-7d, or ISO8601 range)',
        },
        dueAt: {
          type: 'string',
          description: 'Filter by due date (today, thisweek, prev-7d, next-7d, or ISO8601 range)',
        },
        order: {
          type: 'string',
          description: 'Sort order: postDueAt, postUpdatedAt, createdAt (prefix with - for descending)',
        },
        page: {
          type: 'number',
          description: 'Page number (default: 0)',
          minimum: 0,
        },
        size: {
          type: 'number',
          description: 'Items per page (default: 20, max: 100)',
          minimum: 1,
          maximum: 100,
        },
      },
      required: ['projectId'],
    },
  };

• src/index.ts:43-64 (registration)

  Tool registry mapping tool names to handlers and schemas, including 'get-task-list'.

  const toolRegistry = {
    // Common tools
    'get-my-member-info': { handler: getMyMemberInfoHandler, schema: getMyMemberInfoSchema },
  
    // Projects tools
    'get-project-list': { handler: getProjectListHandler, schema: getProjectListSchema },
    'get-project': { handler: getProjectHandler, schema: getProjectSchema },
    'get-task-list': { handler: getTaskListHandler, schema: getTaskListSchema },
    'get-task': { handler: getTaskHandler, schema: getTaskSchema },
    'create-task': { handler: createTaskHandler, schema: createTaskSchema },
    'update-task': { handler: updateTaskHandler, schema: updateTaskSchema },
    'create-task-comment': { handler: createTaskCommentHandler, schema: createTaskCommentSchema },
    'get-task-comment-list': { handler: getTaskCommentListHandler, schema: getTaskCommentListSchema },
    'update-task-comment': { handler: updateTaskCommentHandler, schema: updateTaskCommentSchema },
    'get-milestone-list': { handler: getMilestoneListHandler, schema: getMilestoneListSchema },
    'get-tag-list': { handler: getTagListHandler, schema: getTagListSchema },
    'get-project-template-list': { handler: getProjectTemplateListHandler, schema: getProjectTemplateListSchema },
    'get-project-template': { handler: getProjectTemplateHandler, schema: getProjectTemplateSchema },
    'get-project-member-list': { handler: getProjectMemberListHandler, schema: getProjectMemberListSchema },
    'get-project-member-group-list': { handler: getProjectMemberGroupListHandler, schema: getProjectMemberGroupListSchema },
    'get-project-workflow-list': { handler: getProjectWorkflowListHandler, schema: getProjectWorkflowListSchema },
  };

• src/index.ts:69-87 (registration)

  Array of tool objects used for list_tools request, including getTaskListTool.

  const tools = [
    getMyMemberInfoTool,
    getProjectListTool,
    getProjectTool,
    getTaskListTool,
    getTaskTool,
    createTaskTool,
    updateTaskTool,
    createTaskCommentTool,
    getTaskCommentListTool,
    updateTaskCommentTool,
    getMilestoneListTool,
    getTagListTool,
    getProjectTemplateListTool,
    getProjectTemplateTool,
    getProjectMemberListTool,
    getProjectMemberGroupListTool,
    getProjectWorkflowListTool,
  ];