ClickUp MCP Integration

Instructions

Implementation Reference

• src/controllers/list.controller.ts:40-48 (handler)

  The handler function for the create_list tool. It extracts folder_id and name from input, calls the listService.createList method, and returns the response as JSON-formatted text content.

  handler: async (input) => {
    const { folder_id, name } = input;
    const response = await listService.createList(folder_id, {
      name,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(response) }],
    };
  },

• src/controllers/list.controller.ts:36-39 (schema)

  Zod input schema for the create_list tool, defining required string parameters folder_id and name with descriptions.

  inputSchema: {
    folder_id: z.string().describe("ClickUp folder ID"),
    name: z.string().describe("List name"),
  },

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

  Registration of all tools including create_list via the MCP server's tool() method, using properties from each tool object (name, description, inputSchema, handler). The createListTool is included in the tools array.

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

• src/services/list.service.ts:32-42 (helper)

  Supporting service method in ListService that sends a POST request to the ClickUp API endpoint to create a new list in the specified folder.

  async createList(
    folderId: string,
    params: {
      name: string;
    }
  ) {
    return this.request(`/folder/${folderId}/list`, {
      method: "POST",
      body: JSON.stringify(params),
    });
  }