notes_list
List all Apple Notes or filter by folder to organize and access your notes directly from macOS applications.
Instructions
[Apple Notes operations] List all notes or notes in a specific folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder | No | Optional folder name to list notes from |
Implementation Reference
- src/categories/notes.ts:198-222 (handler)Handler function that generates AppleScript code to list all notes or notes in a specific folder in Apple Notes.app.
script: (args) => { const { folder = "" } = args; if (folder) { return ` tell application "Notes" set folderList to folders whose name is "${folder}" if length of folderList > 0 then set targetFolder to item 1 of folderList set noteNames to name of notes of targetFolder return noteNames as string else return "Folder not found: ${folder}" end if end tell `; } else { return ` tell application "Notes" set noteNames to name of notes return noteNames as string end tell `; } }, - src/categories/notes.ts:223-231 (schema)Input schema defining optional 'folder' parameter for listing notes from a specific folder.
schema: { type: "object", properties: { folder: { type: "string", description: "Optional folder name to list notes from" } } } - src/framework.ts:221-232 (registration)Registers the 'notes_list' tool by constructing the name from category 'notes' and script 'list', along with description and schema.
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: this.categories.flatMap((category) => category.scripts.map((script) => ({ name: `${category.name}_${script.name}`, // Changed from dot to underscore description: `[${category.description}] ${script.description}`, inputSchema: script.schema || { type: "object", properties: {}, }, })), ), })); - src/index.ts:35-35 (registration)Registers the notes category containing the 'list' script, which becomes the 'notes_list' tool.
server.addCategory(notesCategory);