list_folders_tool
List and view the hierarchical structure of folders within your Obsidian vault or a specific directory, aiding in organization, verification, and understanding of folder paths and names.
Instructions
List folders in the vault or a specific directory.
When to use:
- Exploring vault organization structure
- Verifying folder names before creating notes
- Checking if a specific folder exists
- Understanding the hierarchy of the vault
When NOT to use:
- Listing notes (use list_notes instead)
- Searching for content (use search_notes)
Returns:
Folder structure with paths and names
Input Schema
Name | Required | Description | Default |
---|---|---|---|
ctx | No | ||
directory | No | Specific directory to list folders from (optional, defaults to root) | |
recursive | No | Whether to include all nested subfolders |
Input Schema (JSON Schema)
{
"properties": {
"ctx": {
"default": null,
"title": "Ctx"
},
"directory": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Specific directory to list folders from (optional, defaults to root)",
"examples": [
null,
"Projects",
"Daily",
"Archive/2024"
],
"title": "Directory"
},
"recursive": {
"default": true,
"description": "Whether to include all nested subfolders",
"title": "Recursive",
"type": "boolean"
}
},
"type": "object"
}