notesctl (Apple Notes, low-token)

---

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:

{

"openclaw": {

"emoji": "📝",

"os": ["darwin"],

"requires": { "bins": ["memo", "python3", "osascript"] }

}

}

---

# 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)

echo '{"title":"Title","body":"Line 1\nLine 2","folder":"Notes"}' | {baseDir}/scripts/notes_post.sh

{baseDir}/scripts/notes_new.sh "Title" $'Body line 1\nBody 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 export

Output conventions

Notes on editing

Editing existing notes is inherently more fragile: