clickup_get_folders
List all folders in a ClickUp Space to discover existing folders or check which folders override default statuses.
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 |