list_notes
Retrieve notes from an Obsidian vault with optional search filtering to locate specific content.
Instructions
List all notes in the vault with optional search filter (legacy with search support)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Optional search query to filter notes |
Implementation Reference
- src/index.ts:200-202 (handler)The core handler function `listNotes()` in the `ObsidianApiClient` class that makes a GET request to the "/notes" endpoint to list all notes.async listNotes() { return this.request("/notes"); }
- src/index.ts:410-419 (schema)The input schema definition for the "list_notes" tool, which accepts an optional "search" string parameter.{ name: "list_notes", description: "List all notes in the vault with optional search filter (legacy with search support)", inputSchema: { type: "object", properties: { search: { type: "string", description: "Optional search query to filter notes" }, }, }, },
- src/index.ts:508-516 (registration)The dispatch logic in the `CallToolRequestSchema` handler's switch statement that routes "list_notes" calls to either `searchVault` (if search provided) or `listNotes()`.case "list_notes": const searchQuery = args?.search as string; if (searchQuery) { // Use the enhanced search functionality result = await this.client.searchVault(searchQuery, ["content", "filename", "tags"]); } else { result = await this.client.listNotes(); } break;