| name | apple-notes |
| description | Search local Apple Notes efficiently. Use when asked to find notes, search note text, inspect note snippets, or extract links/URLs stored in Apple Notes. |
| disable-model-invocation | true |
Apple Notes
Overview
Search local Apple Notes via the Notes SQLite store instead of manual strings/SQL probing. Use the bundled script to decompress note bodies, search terms, print matched context, and optionally extract URLs near matches.
Quick Start
Run from any directory:
python3 ./scripts/search_notes.py fingerprint bypass --all-terms
Common tasks:
python3 ./scripts/search_notes.py fingerprint bypass
python3 ./scripts/search_notes.py fingerprint bypass --all-terms
python3 ./scripts/search_notes.py fingerprint bypass --github-only --all-terms
python3 ./scripts/search_notes.py "TLS fingerprinting" --show-urls
python3 ./scripts/search_notes.py "TLS fingerprinting" --require-urls
python3 ./scripts/search_notes.py botguard recaptcha --context 1200
Workflow
- Prefer
scripts/search_notes.py for all Apple Notes text/link searches.
- Start with concise terms from the user request.
- Add
--all-terms when the request implies combined concepts, e.g. “fingerprint bypass packages”.
- Add
--show-urls when URLs are requested but any domain is acceptable.
- Add
--github-only only when GitHub/Gist links are specifically requested.
- Add
--require-urls when matching notes must contain at least one URL.
- Increase
--context if relevant surrounding text is omitted or the note is a long scratchpad.
- Return only relevant notes/snippets/links and mention the note title when useful.
Notes Store Details
Default database:
~/Library/Group Containers/group.com.apple.notes/NoteStore.sqlite
The script reads ZICCLOUDSYNCINGOBJECT joined to ZICNOTEDATA, gzip-decompresses ZDATA when needed, decodes UTF-8 leniently, prints context windows around term matches, and extracts http(s) URLs when present.
Validation
After editing the script, run:
python3 ./scripts/test_search_notes.py