apple-notes

name	apple-notes
description	Manage macOS Apple Notes via the memo CLI — create, view, edit, delete, search, move, and export notes across folders. Use when user says "add note", "find note", "show my notes", "create note about...", or "export note".
allowed-tools	["Bash","Read","Write"]
model	haiku
user-invocable	true
when_to_use	When user wants to create, read, search, edit, or manage Apple Notes on macOS. Triggers: "add a note", "create note", "find note about...", "show notes", "edit note", "delete note", "export note", "move note to folder".
argument-hint	<action: list|create|view|edit|delete|search|move|export> <details>

Apple Notes

Manage native macOS Apple Notes using the memo CLI. macOS only.

Prerequisites

brew install antoniorodr/memo/memo

After install, grant Notes access when macOS prompts. If not prompted: System Settings → Privacy & Security → Contacts/Notes → allow Terminal.

Commands

Command	Description
memo list	List all notes (title + folder)
memo list --folder "<Folder>"	List notes in a specific folder
memo create "<Title>" --body "<Content>"	Create a new note
memo view "<Title>"	View note content
memo edit "<Title>" --body "<New Content>"	Replace note body
memo delete "<Title>"	Delete a note
memo search "<Query>"	Search notes by content
memo move "<Title>" --folder "<Destination>"	Move note to a folder
memo export "<Title>" --format md	Export note as Markdown

Usage Examples

Create a quick note:

memo create "Meeting notes 2026-03-21" --body "Discussed Q2 roadmap. Next steps: draft proposal."

Search for a note:

memo search "quarterly roadmap"

View a specific note:

memo view "Meeting notes 2026-03-21"

Export as Markdown to a file:

memo export "Meeting notes 2026-03-21" --format md > workspace/meeting-notes.md

Move note to a folder:

memo move "Meeting notes 2026-03-21" --folder "Work"

Rules

• Always check if CLI is installed first: which memo
• If not installed, show the brew install command and stop
• macOS only — if not on macOS, inform the user and stop
• When creating notes with multi-line content, write content to a temp file and pipe it, or use heredoc via Bash
• When viewing long notes, save to workspace/note-<slug>.md and summarize inline rather than dumping full content
• Search is case-insensitive; use concise query terms
• Keep output concise: confirm action taken in one line
• If a title is ambiguous, run memo list first and ask the user to clarify