LaunchKit · 2026
Back to Skills

mac-notes-agent

Integrate with the macOS Notes app (Apple Notes)

0
1.1k downloads
by @swancho

Setup & Installation

openclaw skills install @swancho/mac-notes-agent

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install mac-notes-agent

Version History

v1.1.0Feb 9, 2026 - Version note by skill developer:

Remove --bodyFile option for security (arbitrary file read). Use --body with \n for multi-line text instead.

What This Skill Does

Connects an AI agent to Apple Notes on macOS using AppleScript through a small Node.js CLI. Supports creating, listing, reading, updating, appending, deleting, and searching notes, with optional folder targeting.

Operates entirely on-device through the native Notes app with no external API, cloud service, or npm dependencies required.

When to use it

  • Save meeting action items directly to Apple Notes during a conversation
  • Search existing notes for a keyword across all folders
  • Append follow-up content to an ongoing project note
  • Organize notes by creating or targeting named folders
  • Retrieve a stored note's content to reference in a follow-up task

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: 'Add a note called "Sprint Goals" to my Work folder with the three items we just discussed'

AGENT
  1. 1Formats the discussed items as newline-separated text
  2. 2Runs the add command with --title, --body, and --folder flags via the CLI
  3. 3Receives JSON confirmation with the synthetic note ID and folder name
  4. 4Reports the title and folder back to the user
OUTPUT

Note "Sprint Goals" created in the Work folder, confirmed with ID Work::2026-03-19T10:00:00::Sprint Goals