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
-
List existing notes to see what's available
-
Read a note to get its HTML content
-
Create new notes with HTML-formatted body
-
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
Element HTML Example
Title <h1>
<h1>Title</h1>
Heading <h2>
<h2>Heading</h2>
Subheading <h3>
<h3>Subheading</h3>
Paragraph <div>
<div>Text here</div>
Bold <b>
<b>bold</b>
Italic <i>
<i>italic</i>
Underline <u>
<u>underline</u>
Strikethrough <strike>
<strike>deleted</strike>
Monospace <tt>
<tt>code</tt>
Line break <br>
<br>
Bullet list <ul><li>
<ul><li>Item 1</li><li>Item 2</li></ul>
Numbered list <ol><li>
<ol><li>First</li><li>Second</li></ol>
Table <object><table>
See below
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