ALucek 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
--titleis 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