clickup_update_task

Instructions

Implementation Reference

• src/controllers/task.controller.ts:126-188 (handler)

  Full definition of the 'clickup_update_task' tool, including name, input schema, description, and handler function that maps inputs to UpdateTaskParams and calls taskService.updateTask

  const updateTaskTool = defineTool((z) => ({
    name: "clickup_update_task",
    description: "Update a task by its ID",
    inputSchema: {
      task_id: z.string().describe("ClickUp task ID"),
      name: z.string().optional().describe("Task name"),
      markdown_description: z
        .string()
        .optional()
        .describe("Task description in markdown format"),
      priority: z
        .number()
        .optional()
        .describe("Task priority (1-4): 1=Urgent, 2=High, 3=Normal, 4=Low"),
      due_date: z
        .number()
        .optional()
        .describe("Due date as Unix timestamp in milliseconds"),
      tags: z
        .array(z.string())
        .optional()
        .describe("Array of tag names to add to the task"),
      time_estimate: z
        .number()
        .optional()
        .describe("Time estimate in milliseconds"),
      assignees: z
        .object({
          add: z
            .array(z.number())
            .optional()
            .describe("Array of user IDs to add to the task"),
          rem: z
            .array(z.number())
            .optional()
            .describe("Array of user IDs to remove from the task"),
        })
        .optional()
        .describe("User IDs to add or remove from the task"),
      parent: z
        .string()
        .optional()
        .describe("Parent task ID to move this task as a subtask"),
    },
    handler: async (input): Promise<any> => {
      const { task_id, ...updateData } = input;
      const taskParams: UpdateTaskParams = {
        name: updateData.name,
        markdown_description: updateData.markdown_description,
        priority: updateData.priority,
        due_date: updateData.due_date,
        tags: updateData.tags,
        time_estimate: updateData.time_estimate,
        assignees: updateData.assignees,
        parent: updateData.parent,
      };
  
      const response = await taskService.updateTask(task_id, taskParams);
      return {
        content: [{ type: "text", text: JSON.stringify(response) }],
      };
    },
  }));

• src/services/task.service.ts:55-63 (helper)

  The TaskService.updateTask helper method that sends a PUT request to the ClickUp API to update the specified task.

  async updateTask(
    taskId: string,
    params: UpdateTaskParams
  ): Promise<ClickUpTask> {
    return this.request<ClickUpTask>(`/task/${taskId}`, {
      method: "PUT",
      body: JSON.stringify(params),
    });
  }

• src/index.ts:89-91 (registration)

  Registration loop where all imported tools, including 'clickup_update_task', are registered on the MCP server using server.tool()

  tools.forEach((tool) => {
    server.tool(tool.name, tool.description, tool.inputSchema, tool.handler);
  });

• src/services/task.service.ts:23-32 (helper)

  Private request helper method in TaskService used by updateTask to make HTTP requests to ClickUp API.

  private async request<T>(
    endpoint: string,
    options: RequestInit = {}
  ): Promise<T> {
    const response = await fetch(`${BASE_URL}${endpoint}`, {
      ...options,
      headers: this.headers,
    });
    return response.json();
  }

• src/controllers/task.controller.ts:129-169 (schema)

  Zod-based input schema for validating parameters to the clickup_update_task tool.

  inputSchema: {
    task_id: z.string().describe("ClickUp task ID"),
    name: z.string().optional().describe("Task name"),
    markdown_description: z
      .string()
      .optional()
      .describe("Task description in markdown format"),
    priority: z
      .number()
      .optional()
      .describe("Task priority (1-4): 1=Urgent, 2=High, 3=Normal, 4=Low"),
    due_date: z
      .number()
      .optional()
      .describe("Due date as Unix timestamp in milliseconds"),
    tags: z
      .array(z.string())
      .optional()
      .describe("Array of tag names to add to the task"),
    time_estimate: z
      .number()
      .optional()
      .describe("Time estimate in milliseconds"),
    assignees: z
      .object({
        add: z
          .array(z.number())
          .optional()
          .describe("Array of user IDs to add to the task"),
        rem: z
          .array(z.number())
          .optional()
          .describe("Array of user IDs to remove from the task"),
      })
      .optional()
      .describe("User IDs to add or remove from the task"),
    parent: z
      .string()
      .optional()
      .describe("Parent task ID to move this task as a subtask"),
  },