get_lists
Retrieve all task lists from a ClickUp folder to organize and manage project workflows.
Instructions
Get all lists in a folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder_id | Yes | ClickUp folder ID |
Implementation Reference
- src/controllers/list.controller.ts:18-31 (handler)Defines the 'get_lists' MCP tool, including its name, description, input schema (folder_id), and handler function that delegates to listService.getLists and formats the response.const getListsTool = defineTool((z) => ({ name: "get_lists", description: "Get all lists in a folder", inputSchema: { folder_id: z.string().describe("ClickUp folder ID"), }, handler: async (input) => { const { folder_id } = input; const response = await listService.getLists(folder_id); return { content: [{ type: "text", text: JSON.stringify(response) }], }; }, }));
- src/services/list.service.ts:28-30 (helper)Helper method in ListService that performs the ClickUp API request to retrieve lists in the specified folder.async getLists(folderId: string) { return this.request<{ lists: any[] }>(`/folder/${folderId}/list`); }
- src/index.ts:89-91 (registration)Registers all tools from the tools array, including 'get_lists', with the MCP server by calling server.tool for each.tools.forEach((tool) => { server.tool(tool.name, tool.description, tool.inputSchema, tool.handler); });
- src/index.ts:43-45 (registration)Includes the getListsTool in the central tools array used for MCP server registration.// List tools getListsTool, createListTool,