- name
- notesctl
- description
- Manage Apple Notes via deterministic local scripts (create, append, list, search, export, and edit). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
- metadata
notesctl (Apple Notes, low-token)
Goal
Minimize token usage and avoid fragile quoting by routing Apple Notes operations through bundled scripts.
Quick start
Create a new note (deterministic title/body)
- JSON stdin (recommended):
echo '{"title":"Title","body":"Line 1\
Line 2","folder":"Notes"}' | {baseDir}/scripts/notes_post.sh- Direct args:
{baseDir}/scripts/notes_new.sh "Title" $'Body line 1\
Body line 2' "Notes"List/search/export
{baseDir}/scripts/notes_list.sh "Notes"
{baseDir}/scripts/notes_search.sh "query" "Notes"
{baseDir}/scripts/notes_export.sh "query" "Notes" "/tmp" # interactive select then exportOutput conventions
- Keep receipts short:
Wrote to Notes: <title>.
Notes on editing
Editing existing notes is inherently more fragile:
- Prefer append workflows or create a new note with a reference.
- If the user explicitly wants interactive editing, use
memo notes -e(manual selection + editor).