List Notes
vault_list_notesFind Markdown note paths in an Obsidian vault by folder or glob pattern, returning only paths for browsing or further retrieval.
Instructions
List .md file paths in the vault, optionally filtered by folder and/or glob pattern. Returns paths only — not content or metadata.
Example: vault_list_notes({ folder: "Projects" }) Example: vault_list_notes({ glob: "**/session-log.md" })
When to use: Browsing what exists in a folder by filename, or finding notes matching a path pattern. Prefer vault_search_by_folder when you need metadata (tags, type, related) along with paths. Prefer vault_search for content-based discovery. Use vault_read_note to read a note from the results.
Parameters:
folder scopes the listing to a path prefix ("Projects" includes "Projects/Archive"). When combined with glob, the glob pattern is applied within the folder's scope.
glob supports * (any filename chars) and ** (any path depth). Applied to vault-relative paths.
Errors:
A nonexistent folder or no glob matches returns an empty array, not an error.
"hidden path blocked" — the folder is hidden (dot-prefixed, like ".obsidian"); hidden folders are not listable, matching Obsidian.
Returns: JSON array of vault-relative path strings (e.g. ["Projects/plan.md", "Notes/idea.md"]).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| glob | No | Glob pattern for path filtering (e.g. "**/*session-log*.md"). Supports * and ** wildcards. Combined with folder when both are set. | |
| folder | No | Folder path prefix (e.g. "About Me", "Projects"). Includes all subfolders. |