Apple Notes Creation & Editing

Overview

agent-notes

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

<h1>

<h1>Title</h1>

<h2>

<h2>Heading</h2>

<h3>

<h3>Subheading</h3>

<div>

<div>Text here</div>

<b>

<b>bold</b>

<i>

<i>italic</i>

<u>

<u>underline</u>

<strike>

<strike>deleted</strike>

<tt>

<tt>code</tt>

<br>

<br>

<ul><li>

<ul><li>Item 1</li><li>Item 2</li></ul>

<ol><li>

<ol><li>First</li><li>Second</li></ol>

<object><table>

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