manage-apple-notes

name	manage-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)
5. Attach clipboard images to existing notes

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"

# Attach clipboard image to note
python scripts/attach-clipboard-image.py --title "My Note"

# Attach clipboard image with a label
python scripts/attach-clipboard-image.py --title "My Note" --label "screenshot.png"

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 via base64 - Technically possible but impractical; use clipboard attachment instead
• Clipboard Images - ✅ Supported via attach-clipboard-image.py (copies image from clipboard to note)
• File Attachments - Only images from clipboard are supported; other file types cannot be added programmatically

Destructive-action safety

• Delete is irreversible — confirm the exact note before deleting.
• Edit = delete + recreate: if recreation fails, the original content is lost. Capture the existing body first, and confirm before replacing.