apple-notes

peerasak-u's avatarfrom peerasak-u

Reads, searches, lists, creates, and deletes notes in Apple Notes on macOS. Use when the user asks about their notes, wants to save information to Notes, or needs to find something they wrote in Apple Notes.

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads
[Knowledge Base]

When & Why to Use This Skill

This Claude skill provides a seamless integration between Claude and Apple Notes on macOS, allowing users to manage their personal and professional knowledge bases through natural language. It solves the problem of context switching by enabling the AI to search, read, create, and organize notes directly within the chat interface, effectively turning Apple Notes into an accessible external memory for the assistant.

Use Cases

  • Meeting Documentation: Automatically save AI-generated meeting summaries or action items into specific Apple Notes folders like 'Work' or 'Projects'.
  • Information Retrieval: Quickly find specific details, such as a budget plan or a historical reference, buried in your notes by asking Claude to search for keywords.
  • Content Drafting: Use Claude to draft articles, reports, or code snippets and instantly export them as formatted Markdown notes to Apple Notes for further editing.
  • Personal Organization: List and read recent notes to stay updated on your daily tasks or to-do lists without manually opening the Notes app.
nameapple-notes
descriptionReads, searches, lists, creates, and deletes notes in Apple Notes on macOS. Use when the user asks about their notes, wants to save information to Notes, or needs to find something they wrote in Apple Notes.

Apple Notes

Interacts with Apple Notes via the @peerasak-u/apple-notes CLI.

Quick Reference

Run commands

bunx @peerasak-u/apple-notes <command> [args]
Command Usage
search <query> Search notes by body content
list <query> List notes by title (returns indexes)
read <title> [folder] Read note content
read-index <query> <index> Read by index from list result
recent [count] [folder] Get recent notes (default: 5)
create <title> <body> [folder] Create note from Markdown
delete <title> [folder] Delete note (exact match)

Full command details: See references/COMMANDS.md

Common Workflows

Find and read a note

bunx @peerasak-u/apple-notes list "budget"
bunx @peerasak-u/apple-notes read-index "budget" 2

Create a note

bunx @peerasak-u/apple-notes create "Meeting Notes" "# Agenda\n- Item 1\n- Item 2" "Work"

Check recent activity

bunx @peerasak-u/apple-notes recent 10

Output Format

  • Note content returns as Markdown
  • If HTML conversion fails, output starts with [RAW_HTML]
  • Errors return strings starting with Error:

Folder Paths

Specify folders as simple names ("Work") or nested paths ("Work/Projects/2024").