apple-notes by NousResearch

Decision brief

What it does—and where it fits

Use memo to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.

Best for

User asks to create, view, or search Apple Notes
Saving information to Notes.app for cross-device access
Organizing notes into folders

Not for

Obsidian vault management → use the obsidian skill
Bear Notes → separate app (not supported here)

Compatibility matrix

Platform support, with evidence labels

Platform	Status	Evidence	What to check
Codex	Not declared	No explicit evidence	Portability before use
Claude Code	Not declared	No explicit evidence	Portability before use
Cursor	Not declared	No explicit evidence	Portability before use
Gemini CLI	Not declared	No explicit evidence	Portability before use

Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource

npx skills add https://github.com/NousResearch/hermes-agent --skill "skills/apple/apple-notes"

Safe inspection promptEditorial

Inspect the Agent Skill "apple-notes" from https://github.com/NousResearch/hermes-agent/blob/f5be9236e00ddf2f2a412697f267078fc4ee068e/skills/apple/apple-notes/SKILL.md at commit f5be9236e00ddf2f2a412697f267078fc4ee068e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

01
Prerequisites
macOS with Notes.app
macOS with Notes.appInstall: brew tap antoniorodr/memo && brew install antoniorodr/memo/memoGrant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)
02
When to Use
User asks to create, view, or search Apple Notes
User asks to create, view, or search Apple NotesSaving information to Notes.app for cross-device accessOrganizing notes into folders
03
When NOT to Use
Obsidian vault management → use the obsidian skill
Obsidian vault management → use the obsidian skillBear Notes → separate app (not supported here)Quick agent-only notes → use the memory tool instead
04
Quick Reference
-a/--add is a bare flag — it opens your $EDITOR to compose the note; it does not take a title argument. Use -f/--folder to target a folder. Set $EDITOR first (e.g. export EDITOR=vim).
-a/--add is a bare flag — it opens your $EDITOR to compose the note; it does not take a title argument. Use -f/--folder to target a folder. Set $EDITOR first (e.g. export EDITOR=vim).

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial

Signal	Value	Evidence type	Meaning
Quality score	87/100	Computed	Documentation, specificity, maintenance, and trust rules
Repository stars	225,255	Source	Repository attention, not individual Skill quality
Compatibility	0 platforms	Source	Declared in the catalog source record
Usage guide	automated source guide	Editorial	Generated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository: NousResearch/hermes-agent
Skill path: skills/apple/apple-notes/SKILL.md
Commit: f5be9236e00ddf2f2a412697f267078fc4ee068e
License: MIT
Collected: 2026-08-04
Default branch: main

View the original SKILL.md

Apple Notes

Use memo to manage Apple Notes directly from the terminal. Notes sync across all Apple devices via iCloud.

Prerequisites

macOS with Notes.app
Install: brew tap antoniorodr/memo && brew install antoniorodr/memo/memo
Grant Automation access to Notes.app when prompted (System Settings → Privacy → Automation)

When to Use

User asks to create, view, or search Apple Notes
Saving information to Notes.app for cross-device access
Organizing notes into folders
Exporting notes to Markdown/HTML

When NOT to Use

Obsidian vault management → use the obsidian skill
Bear Notes → separate app (not supported here)
Quick agent-only notes → use the memory tool instead

Quick Reference

View Notes

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

Create Notes

memo notes -a                     # Add a note (opens your $EDITOR)
memo notes -a -f "Folder Name"    # Add a note into a specific folder

-a/--add is a bare flag — it opens your $EDITOR to compose the note; it does not take a title argument. Use -f/--folder to target a folder. Set $EDITOR first (e.g. export EDITOR=vim).

Edit Notes

memo notes -e                     # Interactive selection to edit

Delete Notes

memo notes -d                     # Interactive selection to delete

Move Notes

memo notes -m                     # Move note to folder (interactive)

Export Notes

memo notes -ex                    # Export to HTML/Markdown

Limitations

Cannot edit notes containing images or attachments
Interactive prompts require terminal access (use pty=true if needed)
macOS only — requires Apple Notes.app

Rules

Prefer Apple Notes when user wants cross-device sync (iPhone/iPad/Mac)
Use the memory tool for agent-internal notes that don't need to sync
Use the obsidian skill for Markdown-native knowledge management