Npjames Apple Notes

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks Clawdbot to add a note, lis...

Security Scan

The skill is an instruction-only wrapper for the memo CLI to manage Apple Notes on macOS; its requirements and instructions are consistent with that purpose, with only minor metadata/packaging inconsistencies to verify before use.

Purpose & Capability

The name/description match the runtime instructions: the skill drives the memo CLI to manage Apple Notes. The only required binary is memo and the Homebrew tap/formula referenced (antoniorodr/memo) is consistent with the stated homepage; no unrelated credentials or system access are requested.

Instruction Scope

SKILL.md only instructs use of memo commands (list, create, edit, delete, move, export) and notes that Automation permission to control Notes.app may be needed. It does not instruct reading unrelated files, exporting data to external endpoints, or accessing unrelated environment variables. It warns about interactive prompts and macOS-only limitations.

Install Mechanism

Install uses a Homebrew tap/formula (antoniorodr/memo/memo). Homebrew formulas from GitHub taps are common and lower-risk than arbitrary downloads, but they are third-party (not core/homebrew). Recommend inspecting the formula/source before installing to confirm there are no surprising post-install actions.

Credentials

The skill requests no environment variables or credentials. It will require macOS Automation permission to control Notes.app (normal and necessary for a Notes CLI). No other credentials or config paths are requested.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request persistent presence or elevated platform privileges, nor does it claim to modify other skills or global agent settings.

Assessment

This skill is essentially documentation for using the memo CLI; it will run memo commands on your Mac and needs Automation permission to access Notes.app (so it can read/write your notes). Before installing: 1) Verify the Homebrew tap/formula (antoniorodr/memo) and the GitHub repo (github.com/antoniorodr/memo) to ensure you trust the source (use 'brew edit' or view the formula on GitHub). 2) Be aware that installing and granting Automation gives the memo binary the ability to read and modify your Apple Notes content. 3) Note a minor metadata mismatch in the packaged _meta.json (different ownerId/slug) — this is likely packaging oversight but you may want to confirm the publisher identity in the registry or inspect the formula commit history. If you are comfortable with the repo and formula, the skill is proportionate to its stated purpose.

Apple Notes CLI

Use memo notes to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.

Setup

• Install (Homebrew): brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
• Manual (pip): pip install . (after cloning the repo)
• macOS-only; if prompted, grant Automation access to Notes.app.

View Notes

• List all notes: memo notes
• Filter by folder: memo notes -f "Folder Name"
• Search notes (fuzzy): memo notes -s "query"

Create Notes

• Add a new note: memo notes -a
  • Opens an interactive editor to compose the note.
• Quick add with title: memo notes -a "Note Title"

Edit Notes

• Edit existing note: memo notes -e
  • Interactive selection of note to edit.

Delete Notes

• Delete a note: memo notes -d
  • Interactive selection of note to delete.

Move Notes

• Move note to folder: memo notes -m
  • Interactive selection of note and destination folder.

Export Notes

• Export to HTML/Markdown: memo notes -ex
  • Exports selected note; uses Mistune for markdown processing.

Limitations

• Cannot edit notes containing images or attachments.
• Interactive prompts may require terminal access.

Notes

• macOS-only.
• Requires Apple Notes.app to be accessible.
• For automation, grant permissions in System Settings > Privacy & Security > Automation.