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

# List notes
python scripts/list-notes.py

# Create note (heredoc for reliable input)
cat << 'EOF' | python scripts/create-note.py --title "My Note"
<div>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 <h1> header. Body content is piped via stdin using heredoc (<< 'EOF') to avoid shell escaping issues.

HTML Reference

Table Example

<object><table><tbody><tr><td>A</td><td>B</td></tr><tr><td>1</td><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