Search by Folder
vault_search_by_folderSearch notes in a folder by path prefix and retrieve full metadata including tags, type, and timestamps. Supports recursive listing and result limits.
Instructions
Browse notes in a folder with full metadata (tags, type, related, created, modified) — unlike vault_list_notes, which returns paths only.
Example: vault_search_by_folder({ folder: "Projects" }) or vault_search_by_folder({ folder: "About Me", recursive: false })
When to use: Exploring a folder's contents with full context for vault orientation. Prefer vault_list_notes when you only need paths. Prefer vault_search when you have a text query. Use vault_get_backlinks or vault_get_outgoing_links to explore how notes in a folder connect to the rest of the vault.
Parameters:
folder is matched as a path prefix; pass it without a trailing slash ("Projects").
recursive (default true) includes all nested subfolders; set false to list only the folder's top level.
limit (default 20) caps results.
Errors:
An empty or nonexistent folder returns an empty array, not an error.
Returns: JSON array of note metadata (path, title, tags, related, folder, type, created, modified, bytes, leading_callout?, additional_properties), sorted by most recently modified. bytes is the on-disk file size.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 20) | |
| folder | Yes | Folder path (e.g. "Projects", "About Me") | |
| recursive | No | Include subfolders (default: true) |