List Notes And Folders
notes.listRead-onlyIdempotent
List notes or folders in your Obsidian vault, scoped by folder and filtered by creation or modification date. Recursively includes subfolders. Read-only.
Instructions
List notes and/or folders in the vault, optionally scoped to a folder and filtered by creation/modification date. include selects what to return (notes, folders, or both). recursive:true descends into subfolders. since/until (ISO dates) combined with dateField (created or modified, default modified) narrow the result by date. Read-only.
Operates on the session-active vault (see vault.current — selectable via vault.select) unless an explicit vaultPath argument is passed, which always wins.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder | No | Optional folder to scope the listing. | |
| include | No | What to list — markdown notes, folders, or both (returns items tagged by kind). | notes |
| recursive | No | Recurse into subfolders. Default false. | |
| since | No | Only include items dated on or after this ISO date. | |
| until | No | Only include items dated on or before this ISO date. | |
| dateField | No | Which date the `since`/`until` filter applies to. Defaults to `modified`. | |
| vaultPath | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Number of items in `items`. | |
| items | Yes | List of result items; per-item shape depends on the tool. |