get_lists
Retrieve all lists within a specified ClickUp folder to organize and manage project tasks and workflows efficiently.
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)Definition of the 'get_lists' tool, including input schema and the handler function that extracts folder_id, calls listService.getLists, and returns the JSON-stringified 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)The supporting getLists method in ListService that performs the API request to retrieve lists from a ClickUp folder.async getLists(folderId: string) { return this.request<{ lists: any[] }>(`/folder/${folderId}/list`); }
- src/index.ts:21-21 (registration)Import statement bringing getListsTool into the main index file.import { getListsTool, createListTool } from "./controllers/list.controller";
- src/index.ts:44-44 (registration)Inclusion of getListsTool in the array of tools to be registered with the MCP server.getListsTool,
- src/index.ts:89-91 (registration)The loop that registers each tool, including get_lists, with the MCP server by calling server.tool.tools.forEach((tool) => { server.tool(tool.name, tool.description, tool.inputSchema, tool.handler); });