Przejdź do treści
Biblioteka skilli
Produktywność osobista · Integracja z narzędziem

apple-notes-install-auth

/apple-notes-install-auth

Konfiguruje dostęp automatyzacji macOS do Apple Notes przez AppleScript, JXA i Skróty: uprawnienia dostępności i dostęp osascript.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Konfiguruje dostęp automatyzacji macOS do Apple Notes przez AppleScript, JXA i Skróty: uprawnienia dostępności i dostęp osascript.

Wyzwalacze z opisu

setup apple notesapple notes automationapple notes permissions
Oryginalny opis (EN)

Set up macOS automation access for Apple Notes via AppleScript, JXA, and Shortcuts. Use when configuring accessibility permissions, setting up osascript access, or initializing Apple Notes automation on macOS. Trigger: "setup apple notes", "apple notes automation", "apple notes permissions".

Jak działa

  1. Overview
  2. Prerequisites
  3. Instructions
  4. Automation Technologies
  5. Output
  6. Examples
  7. Error Handling
  8. Resources
  9. Next Steps
Sekcje z nagłówków SKILL.md, w oryginale · 122 linii, 613 słów
Podgląd SKILL.md
---
name: apple-notes-install-auth
description: 'Set up macOS automation access for Apple Notes via AppleScript, JXA,
  and Shortcuts.

  Use when configuring accessibility permissions, setting up osascript access,

  or initializing Apple Notes automation on macOS.

  Trigger: "setup apple notes", "apple notes automation", "apple notes permissions".

  '
allowed-tools: Read, Write, Edit, Bash(osascript:*), Bash(defaults:*), Grep
version: 1.6.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- macos
- apple-notes
- automation
- applescript
compatibility: Designed for Claude Code
---
# Apple Notes Install & Auth

## Overview

Apple Notes has no REST API. Automation uses macOS scripting technologies: AppleScript, JavaScript for Automation (JXA), Shortcuts, and the `osascript` command-line tool. No SDK to install — but you need macOS accessibility permissions.

## Prerequisites

- macOS 13+ (Ventura or later recommended)
- Terminal app or iTerm2
- System Preferences > Privacy & Security > Automation permissions

## Instructions

### Step 1: Grant Automation Permissions

```bash
# macOS requires explicit permission for scripts to control Notes.app
# The first time you run an osascript command targeting Notes, macOS will prompt.
# You can also pre-grant in: System Preferences > Privacy & Security > Automation

# Test basic Notes access (will trigger permission prompt)
osascript -e 'tell application "Notes" to get name of every note in default account'
```

### Step 2: Verify JXA (JavaScript for Automation) Access

```bash
# JXA is the modern alternative to AppleScript
# Run JavaScript via osascript with -l JavaScript flag

osascript -l JavaScript -e '
  const Notes = Application("Notes");
  Notes.includeStandardAdditions = true;
  const noteCount = Notes.defaultAccount.notes.length;
  `Apple Notes accessible: ${noteCount} notes found`;
'
```

### Step 3: Create a Wrapper Script

```bash
#!/bin/bash
# scripts/notes-cli.sh — Wrapper for common Apple Notes operations

case "$1" in
  count)
    osascript -l JavaScript -e '
      const Notes = Application("Notes");
      Notes.defaultAccount.notes.length;
    '
    ;;
  list)
    osascript -l JavaScript -e '
      const Notes = Application("Notes");
      const notes = Notes.defaultAccount.notes();
      notes.slice(0, 20).map(n => `${n.id()} | ${n.name()}`).join("\n");
    '
    ;;
  folders)
    osascript -l JavaScript -e '
      const Notes = Application("Notes");
      Notes.defaultAccount.folders().map(f => f.name()).join("\n");
    '
    ;;
  *)
    echo "Usage: notes-cli.sh {count|list|folders}"
    ;;
esac
```

### Step 4: Verify Shortcuts Integration

```bash
# Apple Shortcuts can also interact with Notes
# Check available shortcuts
shortcuts list | grep -i note

# Run a shortcut that creates a note
shortcuts run "Create Note" --input-path /dev/stdin <<< "Test content"
```

## Automation Technologies

| Technology | Language | Best For | Docs |
|-----------|----------|----------|------|
| AppleScript | AppleScript | Simple operations | Apple Scripting Guide |
| JXA | JavaScript | Complex logic, JSON handling | Apple JXA Reference |
| osascript | CLI wrapper | Scripts, CI/CD | `man osascript` |
| Shortcuts | Visual | Non-developer workflows | Shortcuts app |
| PyXA | Python | Python automation | pyxa.dev |

## Output

- A recorded consent decision for the exact invoking app and macOS user
- A read-only, scoped authorization result (not a complete note listing)
- A wrapper that exposes only the approved operations and fails on unknown input
- An explicit decision on whether any Shortcuts workflow is approved

## Examples

For a first-time setup, run one read-only count against the intended account and accept the macOS prompt in the interactive session. Do not use the `list` wrapper against a production account unless the task specifically requires metadata discovery; it can expose titles in terminal history and CI logs. For Shortcuts, use a non-production shortcut and a test note rather than a workflow that creates notes in a default account.

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| `Not authorized to send Apple events` | Missing automation permission | Grant in System Preferences > Privacy > Automation |
| `Notes got an error: AppleEvent timed out` | Notes.app not running | Launch Notes first or add `activate` |
| `-1743 errAEAppNotAllowed` | Denied by TCC | Reset TCC: `tccutil reset AppleEvents` |
| `execution error: Notes is not running` | Notes.app closed | Add `tell app "Notes" to activate` |

## Resources

- [Mac Automation Scripting Guide](https://developer.apple.com/library/archive/documentation/LanguagesUtilities/Conceptual/MacAutomationScriptingGuide/)
- [JXA Reference](https://developer.apple.com/library/archive/releasenotes/InterapplicationCommunication/RN-JavaScriptForAutomation/)
- [AppleScript Notes Dictionary](https://www.macosxautomation.com/applescript/notes/)

## Next Steps

Proceed to `apple-notes-hello-world` for your first note creation.

Wersje

W bazie nie ma innych skilli o nazwie apple-notes-install-auth.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 8836810121af (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100apple-notes-hello-world
    Tworzy, czyta i wypisuje notatki Apple Notes przez JXA i AppleScript, do nauki automatyzacji i testu dostępu do zapisu i odczytu.
  • 100applescript
    Automatyzuje macOS przez AppleScript i JXA: sterowanie aplikacjami i systemem, osascript i integracja z aplikacjami macOS.
  • 100automating-mac-apps
    Automatyzuje aplikacje macOS przez Apple Events w AppleScript, JXA i PyXA, jako podstawowa wiedza dla całej automatyzacji aplikacji Mac.
  • 100apple-notes
    Tworzy, wyszukuje i czyta notatki Apple przez osascript, także z formatowaniem i natywnymi listami zadań.
  • 100apple-calendar
    Odczytuje wydarzenia z kalendarza macOS przez CLI icalBuddy i tworzy nowe przez AppleScript (osascript), pokazując agendę i nadchodzące spotkania.
  • 100automating-notes
    Automatyzuje Apple Notes przez JXA: konta, foldery, notatki, treści HTML, zapytania, przenoszenie oraz zapasowe mosty Objective-C i UI.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.