ClickUp MCP Server

by v4lheru
Verified

delete_folder

Permanently remove a folder from your ClickUp workspace. Use with caution as deletion cannot be undone and will remove all lists and tasks within the folder. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups.

Input Schema

NameRequiredDescriptionDefault
folderIdNoID of the folder to delete (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
folderNameNoName of the folder to delete - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses.
spaceIdNoID of the space containing the folder (optional if using spaceName instead, and only needed when using folderName). If you have this ID from a previous response, use it directly rather than looking up by name.
spaceNameNoName of the space containing the folder (optional if using spaceId instead, and only needed when using folderName). Only use this if you don't already have the space ID from previous responses.

Input Schema (JSON Schema)

{ "oneOf": [ { "required": [ "folderId" ] }, { "required": [ "folderName", "spaceId" ] }, { "required": [ "folderName", "spaceName" ] } ], "properties": { "folderId": { "description": "ID of the folder to delete (optional if using folderName instead). If you have this ID from a previous response, use it directly rather than looking up by name.", "type": "string" }, "folderName": { "description": "Name of the folder to delete - will automatically find the folder by name (optional if using folderId instead). Only use this if you don't already have the folder ID from previous responses.", "type": "string" }, "spaceId": { "description": "ID of the space containing the folder (optional if using spaceName instead, and only needed when using folderName). If you have this ID from a previous response, use it directly rather than looking up by name.", "type": "string" }, "spaceName": { "description": "Name of the space containing the folder (optional if using spaceId instead, and only needed when using folderName). Only use this if you don't already have the space ID from previous responses.", "type": "string" } }, "type": "object" }