delete_list
Remove a ClickUp list and all its tasks. Permanently delete any list by providing its ID.
Instructions
Delete a list from ClickUp. Removes the list and its tasks.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | The ID of the list to delete |
Implementation Reference
- src/tools/task-tools.ts:399-419 (registration)Registration of the 'delete_list' MCP tool with input schema (list_id) and handler that calls listsClient.deleteList
server.tool( 'delete_list', 'Delete a list from ClickUp. Removes the list and its tasks.', { list_id: z.string().describe('The ID of the list to delete') }, async ({ list_id }) => { try { const result = await listsClient.deleteList(list_id); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] }; } catch (error: any) { console.error('Error deleting list:', error); return { content: [{ type: 'text', text: `Error deleting list: ${error.message}` }], isError: true }; } } ); - src/tools/task-tools.ts:402-404 (schema)Input schema for delete_list: expects a single string parameter 'list_id'
{ list_id: z.string().describe('The ID of the list to delete') }, - src/clickup-client/lists.ts:94-96 (handler)The ListsClient.deleteList method that performs the actual HTTP DELETE to the ClickUp API endpoint /list/{listId}
async deleteList(listId: string): Promise<{ success: boolean }> { return this.client.delete(`/list/${listId}`); } - src/clickup-client/index.ts:64-67 (helper)The underlying HTTP DELETE method on ClickUpClient that makes the actual axios call
async delete<T = any>(endpoint: string): Promise<T> { const response = await this.axiosInstance.delete(endpoint); return response.data; }