Notesctl

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.

Audits

Suspicious

ClawScanSuspicious

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install notesctl-skill-for-openclaw

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\nLine 2","folder":"Notes"}' | {baseDir}/scripts/notes_post.sh

Direct args:

{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

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