apple-notes

Apple Notes

Use this skill to interact with the Apple Notes app on macOS via AppleScript.

Platform requirement

macOS only. Verify with:

uname -s   # must return Darwin
which osascript

Create a note

osascript -e '
tell application "Notes"
  tell account "iCloud"
    make new note at folder "Notes" with properties {name:"Title", body:"Body text here"}
  end tell
end tell'

Read a note by name

osascript -e '
tell application "Notes"
  set theNote to note "Title" of folder "Notes" of account "iCloud"
  return body of theNote
end tell'

List all notes

osascript -e '
tell application "Notes"
  set noteNames to {}
  repeat with n in notes of folder "Notes" of account "iCloud"
    set end of noteNames to name of n
  end repeat
  return noteNames
end tell'

Search notes (by name substring)

osascript -e '
tell application "Notes"
  set results to {}
  repeat with n in notes of folder "Notes" of account "iCloud"
    if name of n contains "search term" then
      set end of results to name of n
    end if
  end repeat
  return results
end tell'

Update/append to a note

osascript -e '
tell application "Notes"
  set theNote to note "Title" of folder "Notes" of account "iCloud"
  set body of theNote to (body of theNote) & "<br>Appended content"
end tell'

Safety notes

• Notes body is HTML; use <br> for line breaks.
• Specify account (iCloud vs On My Mac) to avoid ambiguity.
• Requires Accessibility/Automation permission for Terminal/agent process.