list_notes_tool
Retrieve a hierarchical overview of notes in your Obsidian vault or specific directory to understand vault organization and locate files before bulk operations.
Instructions
List notes in the vault or a specific directory.
When to use:
Getting an overview of vault structure
Finding notes in a specific folder
Checking what notes exist before bulk operations
Understanding vault organization
When NOT to use:
Searching for specific content (use search_notes)
Finding notes by properties (use search_by_property)
Just counting notes (this loads full paths)
Performance notes:
Fast for directories with <100 notes
May be slower for large vaults (1000+ notes) with recursive=True
Returns: Hierarchical structure of notes with paths and folder organization
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_notes_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| directory | No | ||
| recursive | No | Include notes from all subfolders. Set to false for only immediate children. | |
| ctx | No |