clickup_get_folders
List folders in a ClickUp space using space ID. Supports filtering by archived status and client-side pagination. Returns folder details with task and list counts.
Instructions
List the Folders in a Space.
Calls GET /space/{space_id}/folder. Returns each Folder's task/list
counts and its override_statuses flag; use clickup_get_folder for
the full status list and nested Lists of one Folder.
When to Use:
To discover what Folders exist in a Space before creating or updating one.
To check which Folders already override the Space's statuses.
When NOT to Use:
To fetch one Folder's full detail — use
clickup_get_folder.To list Lists that live directly in the Space (no Folder) — use the folderless-lists tool in
tools/lists.pyonce available.
Returns:
A markdown or JSON list of Folders, or an Error ... string.
Pagination:
ClickUp returns the full Folder array in one response; this tool slices
it client-side via limit/offset for context-window safety.
Examples: params = {"space_id": "90130912", "archived": False, "limit": 20, "offset": 0}
Error Handling:
404 means space_id doesn't exist or isn't accessible.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |