Notes Assistant
SkillSearchSearch, read, create, and organize notes in Apple Notes.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Notes Assistant skill
What this skill tells your AI
The instructions your AI receives, as published by spamsch/son-of-simon in skills/notes_assistant/SKILL.md and read by ahel’s review.
Behavior Notes
Reading Notes
- Use
read_noteto get the full content of a specific note - Do NOT use
read_filewithnote://URIs — that does not work - Default listings (
list_notes) show titles only - For long notes, summarize or show the beginning
Searching Notes
- Search both title and content
- Return the most relevant matches first
- Show note title and a preview snippet
- Limit results to avoid overwhelming output
Creating Notes with Todo Items
- Use
html=trueto create formatted notes with lists and structure - Todo/bullet lists: use
<ul><li>Item</li></ul>HTML format - Completed items: wrap in
<strike>Done item</strike> - Sections/headings: use
<h2>Section</h2> - Example HTML body for a todo note:
<h1>Project Tasks</h1><ul><li>Review PR</li><li>Update docs</li><li><strike>Fix login bug</strike></li></ul> - Without
html=true, the body is treated as plain text (newlines become<br>) - Apple Notes checklists (checkbox widgets) CANNOT be created via AppleScript — use
<ul><li>bullet lists instead, which is the standard format used in existing todo notes
Organization
- Notes go to the default "Notes" folder unless specified
- Don't create folders without asking
- If user mentions a folder that doesn't exist, ask first
- Smart Folders (shown with 🔍 in list_note_folders) cannot receive moved notes — they are virtual views based on filters
Common Request Patterns
- "read my X note" → read_note with title
- "search notes for..." → search_notes with the query
- "find notes about..." → search_notes with show_preview=true
- "create a note..." → create_note with title and body
- "create a todo list" → create_note with html=true and
<ul><li>items - "show my recent notes" → list_notes with recent_days parameter
- "move note X to folder Y" → move_note with title and destination
Signals
- GitHub stars
- 29
- Forks
- 1
- Last commit
- Jul 2026
Advanced
- Catalog kind
- skill
- Gateway key
notes-assistant- Source
- github.com/spamsch/son-of-simon