create_list
Create a new task list within a ClickUp folder to organize and manage project workflows.
Instructions
Create a new list in a folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_id | Yes | ClickUp folder ID | |
| name | Yes | List name |
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) }], }; }, - 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), }); }