apple-notes

Read and search Apple Notes via AppleScript on macOS.

2|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/eins78/agent-skills --skill apple-notes-eins78
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-notes
Source: https://github.com/eins78/agent-skills/tree/main/skills/apple-notes
Command: npx skills add https://github.com/eins78/agent-skills --skill apple-notes-eins78

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Read-only access to Apple Notes via AppleScript to read, list, and search notes without creating or altering content.

Core Features & Use Cases

  • List folders and notes across accounts.
  • Read a note's HTML body for display in UI.
  • Search notes by keyword across accounts and folders.

Quick Start

Use the included scripts under scripts/ to list folders, read a note by name, or search notes by keyword.

Frequently Asked Questions about apple-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read Apple Notes content programmatically on macOS?

This Skill provides read-only access to Apple Notes via AppleScript, enabling you to list folders and notes, read HTML bodies, and search by keyword across accounts without creating or altering content.

Can I search across all my Apple Notes accounts using AppleScript?

Yes, the provided AppleScript scripts support keyword-based note search across multiple accounts and folders, returning matching notes and handling permissions and timeouts gracefully.

Does this AppleScript approach allow editing or creating new notes in Notes.app?

No, this approach is strictly read-only. It is designed to list, read, and search notes without creating, modifying, or deleting any content in Notes.app.

What do I need to set up to access Apple Notes HTML bodies via automation?

You need macOS with Notes.app installed and the provided scripts. The system handles AppleScript permission prompts, timeouts, and errors gracefully to retrieve the HTML body.

Why does my AppleScript automation for Notes.app fail to return content?

AppleScript automation for Notes.app may fail if macOS system permissions are not granted. The scripts handle these permission prompts and potential timeouts gracefully to prevent silent failures.