--- name: apple-notes description: Interact with the Apple Notes app. CRUD operations for persistent storage of thoughts, data, and information across sessions. license: MIT License metadata: author: "lucek.ai" version: "1.0.0" --- # Apple Notes Creation & Editing ## Overview Tools to interact with Apple Notes. Notes are scoped to an automatically created `agent-notes` folder. Notes are formatted using HTML—supported elements are listed below. ## When to Use - Storing information that should persist across sessions - Saving notes, ideas, or data the User wants to keep - Creating task lists, reminders, or reference material - When the User explicitly asks to save\/remember something in notes ## How to Use 1. **List** existing notes to see what's available 2. **Read** a note to get its HTML content 3. **Create** new notes with HTML-formatted body 4. **Delete** notes by title (to edit: read → delete → create) ## Usage ```bash # List notes python scripts\/list-notes.py # Create note (heredoc for reliable input) cat << 'EOF' | python scripts\/create-note.py --title "My Note"

Content here<\/div> EOF # Read note python scripts\/read-note.py --title "My Note" # Delete note python scripts\/delete-note.py --title "My Note" ``` > **Note:** The `--title` is automatically formatted as an `

` header. Body content is piped via stdin using heredoc (`<< 'EOF'`) to avoid shell escaping issues. ## HTML Reference | Element | HTML | Example | |---------|------|---------| | Title | `

` | `

Title<\/h1>` | | Heading | `

` | `

Heading<\/h2>` | | Subheading | `

` | `

Subheading<\/h3>` | | Paragraph | `
` | `
Text here<\/div>` | | Bold | `` | `bold<\/b>` | | Italic | `` | `italic<\/i>` | | Underline | `` | `underline<\/u>` | | Strikethrough | `` | `deleted<\/strike>` | | Monospace | `` | `code<\/tt>` | | Line break | ` ` | ` ` | | Bullet list | `` | `Item 1<\/li> Item 2<\/li><\/ul>` | | Numbered list | `` | `First<\/li> Second<\/li><\/ol>` | | Table | `

A<\/td>	B<\/td><\/tr>
1<\/td>	2<\/td><\/tr><\/tbody><\/table><\/object> ``` ## Limitations - Checklists - Stored internally, checkbox state not accessible (renders as regular bullet list) - Links - Stripped on save - Highlights - Stored internally by Apple Notes - Images - Technically possible (base64) but impractical for LLM use - Attachments - Cannot be added programmatically