ClickUp MCP Server

by v4lheru
Verified

get_folder

Retrieve details about a specific ClickUp folder including its name, status, and other metadata. Before calling, check if you already have the necessary folder ID from previous responses in the conversation history, as this avoids redundant lookups. Helps you understand folder structure before creating or updating lists.

Input Schema

NameRequiredDescriptionDefault
folderIdNoID of the folder to retrieve (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 retrieve - 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 retrieve (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 retrieve - 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" }