automating-notes
/automating-notes
Automatyzuje Apple Notes przez JXA: konta, foldery, notatki, treści HTML, zapytania, przenoszenie oraz zapasowe mosty Objective-C i UI.
- Autor
- SpillwaveSolutions ↗
- Repozytorium
- automating-mac-apps-plugin ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 22.08.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 11
- Skrypty
- 5
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 22.08.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 5 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/create_note.py, scripts/create_notes_folder.py, scripts/search_notes.py, scripts/set_up_notes_automation.py, scripts/set_up_notes_automation.sh
Co robi i kiedy
Automatyzuje Apple Notes przez JXA: konta, foldery, notatki, treści HTML, zapytania, przenoszenie oraz zapasowe mosty Objective-C i UI.
Wyzwalacze z opisu
Oryginalny opis (EN)
Automates Apple Notes via JXA. Use when asked to "create notes programmatically", "automate Notes app", "JXA notes scripting", or "organize notes with automation". Covers accounts/folders/notes, HTML bodies, queries, moves, and Objective-C/UI fallbacks for Notes.app automation on macOS.
Jak działa
- Relationship to the macOS automation skill
- Core framing
- Workflow (default)
- Quickstart (ensure path + create)
- Validation Checklist
- HTML & fallbacks
- When Not to Use
- What to load
Podgląd SKILL.md
---
name: automating-notes
description: Automates Apple Notes via JXA. Use when asked to "create notes programmatically", "automate Notes app", "JXA notes scripting", or "organize notes with automation". Covers accounts/folders/notes, HTML bodies, queries, moves, and Objective-C/UI fallbacks for Notes.app automation on macOS.
allowed-tools:
- Bash
- Read
- Write
---
# Automating Apple Notes (JXA-first, AppleScript discovery)
## Relationship to the macOS automation skill
- Standalone for Notes; reuse `automating-mac-apps` for permissions, shell, and Objective-C/UI scripting patterns.
- **PyXA Installation:** To use PyXA examples in this skill, see the installation instructions in `automating-mac-apps` skill (PyXA Installation section).
## Core framing
- Notes uses an AEOM hierarchy: Application → Accounts → Folders → Notes (with nested folders).
- **Load:** `automating-notes/references/notes-basics.md` for complete specifier reference.
## Workflow (default)
1) Resolve account/folder explicitly (iCloud vs On My Mac); validate existence and permissions.
2) Ensure target path exists (create folders if needed); handle creation failures gracefully.
3) Create notes with explicit `name` and HTML `body`; verify creation success.
4) Query/update with `.whose` filters; batch delete/move as needed; check counts before/after operations.
5) For checklists/attachments, use clipboard/Objective-C scripting if dictionary support is insufficient; test fallbacks.
6) For meeting/people workflows, file notes under `meetings/<company>/<date>-<meeting-title>` and `people/<first>-<last>/...`; validate final structure.
## Quickstart (ensure path + create)
**JXA (Legacy):**
```javascript
const Notes = Application("Notes");
// Ensure folder path exists, creating intermediate folders as needed
function ensurePath(acc, path) {
const parts = path.split("/").filter(Boolean);
let container = acc;
parts.forEach(seg => {
let f; try {
f = container.folders.byName(seg);
f.name(); // Verify access
} catch (e) {
// Folder doesn't exist, create it
f = Notes.Folder({ name: seg });
container.folders.push(f);
}
container = f;
});
return container;
}
try {
// Get iCloud account and ensure meeting folder exists
const acc = Notes.accounts.byName("iCloud");
const folder = ensurePath(acc, "meetings/Acme/2024-07-01-Review");
// Create new note in the folder
folder.notes.push(Notes.Note({
name: "Client Review",
body: "<h1>Client Review</h1><div>Agenda...</div>"
}));
console.log("Note created successfully");
} catch (e) {
console.error("Failed to create note: " + e.message);
}
```
**PyXA (Recommended Modern Approach):**
```python
import PyXA
notes = PyXA.Notes()
def ensure_path(account, path):
"""Ensure folder path exists, creating intermediate folders as needed"""
parts = [p for p in path.split("/") if p] # Filter empty parts
container = account
for part in parts:
try:
# Try to find existing folder
folder = container.folders().by_name(part)
folder.name() # Verify access
except:
# Folder doesn't exist, create it
folder = notes.make("folder", {"name": part})
container.folders().push(folder)
container = folder
return container
try:
# Get iCloud account
account = notes.accounts().by_name("iCloud")
# Ensure meeting folder exists
folder = ensure_path(account, "meetings/Acme/2024-07-01-Review")
# Create new note in the folder
note = folder.notes().push({
"name": "Client Review",
"body": "<h1>Client Review</h1><div>Agenda...</div>"
})
print("Note created successfully")
except Exception as e:
print(f"Failed to create note: {e}")
```
**PyObjC with Scripting Bridge:**
```python
from ScriptingBridge import SBApplication
notes = SBApplication.applicationWithBundleIdentifier_("com.apple.Notes")
def ensure_path(account, path):
"""Ensure folder path exists, creating intermediate folders as needed"""
parts = [p for p in path.split("/") if p]
container = account
for part in parts:
try:
folder = container.folders().objectWithName_(part)
folder.name() # Verify access
except:
# Create new folder
folder = notes.classForScriptingClass_("folder").alloc().init()
folder.setName_(part)
container.folders().addObject_(folder)
container = folder
return container
try:
# Get iCloud account
accounts = notes.accounts()
account = None
for acc in accounts:
if acc.name() == "iCloud":
account = acc
break
if account:
# Ensure meeting folder exists
folder = ensure_path(account, "meetings/Acme/2024-07-01-Review")
# Create new note
note = notes.classForScriptingClass_("note").alloc().init()
note.setName_("Client Review")
note.setBody_("<h1>Client Review</h1><div>Agenda...</div>")
folder.notes().addObject_(note)
print("Note created successfully")
else:
print("iCloud account not found")
except Exception as e:
print(f"Failed to create note: {e}")
```
## Validation Checklist
- [ ] Account access works (iCloud vs On My Mac)
- [ ] Folder creation and path resolution succeeds
- [ ] Note creation with valid HTML body completes
- [ ] Note appears in Notes UI
- [ ] `.whose` queries return expected results
- [ ] Error handling covers missing accounts/folders
## HTML & fallbacks
- Allowed tags: `<h1>-<h3>`, `<b>`, `<i>`, `<u>`, `<ul>/<ol>/<li>`, `<div>/<p>/<br>`, `<a>`.
- **Security:** Always sanitize HTML input; avoid `<script>`, `<style>`, or event handlers to prevent XSS in rendered notes.
- Checklists/attachments: Objective-C/clipboard fallback (Cmd+Shift+L for checklist, paste image via NSPasteboard + System Events).
- Append helper: replace `</body>` with extra HTML, or append when missing; validate HTML structure post-modification.
## When Not to Use
- Cross-platform note taking (use Notion API, Obsidian, or Markdown files)
- iCloud sync operations requiring status feedback (limited API support)
- Non-macOS platforms
- Rich formatting beyond supported HTML tags
- Collaborative editing workflows (no multi-user support)
## What to load
- Basics & specifiers: `automating-notes/references/notes-basics.md`
- Recipes (create/move/query/ensure path/checklists): `automating-notes/references/notes-recipes.md`
- Advanced (HTML body rules, attachments/UI, JSON import/export, ObjC bridge): `automating-notes/references/notes-advanced.md`
- Dictionary/type map: `automating-notes/references/notes-dictionary.md`
- **PyXA API Reference** (complete class/method docs): `automating-notes/references/notes-pyxa-api-reference.md`
Pliki w paczce (11)
- SKILL.md 7 KB
- references/notes-advanced.md 1 KB
- references/notes-basics.md 1 KB
- references/notes-dictionary.md 1 KB
- references/notes-pyxa-api-reference.md 18 KB
- references/notes-recipes.md 4 KB
- scripts/create_note.py 2 KB
- scripts/create_notes_folder.py 2 KB
- scripts/search_notes.py 2 KB
- scripts/set_up_notes_automation.py 1 KB
- scripts/set_up_notes_automation.sh 1 KB
Wersje
W bazie nie ma innych skilli o nazwie automating-notes.
Migawka bazy z 13.11.2026 · wersja paczki 6c8dd4fb5c73 (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
- 100automating-contacts
Automatyzuje Kontakty macOS przez JXA ze słownikiem AppleScript: zapytania, CRUD, pola wielowartościowe, grupy, obrazy i zapasowe mosty ObjC. - 100automating-reminders
Automatyzuje Przypomnienia Apple przez JXA: listy i przypomnienia, filtrowanie zapytaniami whose, wydajne tworzenie przez konstruktory i push oraz przenoszenie przez kopiowanie i usuwanie. - 100apple-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. - 100apple-notes-core-workflow-a
Buduje zautomatyzowane przepływy zarządzania notatkami w Apple Notes skryptami JXA: masowe tworzenie, synchronizacja ze źródeł zewnętrznych, foldery i szablony. - 100apple-notes
Obsługuje Apple Notes na macOS: tworzy, przeszukuje, aktualizuje i porządkuje notatki oraz foldery przez narzędzia MCP. - 100apple-notes
Zarządza Apple Notes na macOS: listuje, wyszukuje, czyta, tworzy, dopisuje, przenosi, usuwa i eksportuje notatki oraz zarządza folderami, lokalnie w Notes.app.