apple-notes
npx machina-cli add skill ALucek/apple-notes/apple-notes --openclawApple 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
Source
git clone https://github.com/ALucek/apple-notes/blob/main/plugins/apple-notes/skills/apple-notes/SKILL.mdView on GitHub Overview
Tools to create, read, update, and delete notes in the Apple Notes app within agent workflows. Notes live in an auto-created agent-notes folder and are HTML-formatted for rich content. This enables persistent storage of thoughts, ideas, and data across conversations.
How This Skill Works
Uses a local Apple Notes integration to list, read, create (HTML body), and delete notes by title. Titles are automatically formatted as an <h1> header, and note bodies are supplied via stdin using heredoc to avoid shell escaping issues.
When to Use It
- Persist information across sessions
- Save notes, ideas, or data for later reference
- Create task lists, reminders, or reference material
- Respond to explicit requests to save or remember something
- Organize and retrieve content for projects or conversations
Quick Start
- Step 1: List existing notes with the command for listing notes
- Step 2: Create a new note using a heredoc and the create-note script
- Step 3: Read or delete a note with the appropriate commands
Best Practices
- Use clear, unique titles since the title becomes an <h1> header
- Structure content with HTML tags (<div>, <h2>, <b>, etc.) for readability
- Use heredoc input to reliably include multi-line HTML
- Read a note before deleting to confirm content
- Prune outdated notes to reduce clutter and storage usage
Example Use Cases
- Save a meeting summary for later review
- Capture research references in a dedicated note
- Create a to-do list that persists across sessions
- Jot down brainstorming ideas for a project
- Store user preferences or constraints for prompts
