Agent skill · data analytics · sickn33
apple-notes-search
Semantic + keyword search and connection-discovery across the user's own Apple Notes via the apple-notes MCP server. Use when the user wants to find, recall, or synthesize something from their notes, or surface non-obvious bridges/related notes. macOS, on-device.
Why this skill is useful
Provides specific commands and setup procedures for integrating with the Apple Notes MCP server that the AI wouldn't reliably generate on its own.
What it needs
Requires bun installed locally. About 5k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Apple Notes search & connection-discovery apple-notes is an MCP server for semantic search and connection-discovery across the user's own Apple Notes — hybrid search, Swanson-ABC bridges, entity threads, and cited synthesis over everything they've written. Embeddings, search, BM25, clustering, and bridges run on-device; only synthesis generation calls an LLM (local OR cloud, the user's choice). This skill covers (1) the one-time setup you must walk the user through, and (2) which tool to reach for, since the server exposes many. When to Use This Skill Use when the user wants to find, recall, or look up something from their own Apple Notes ("search my notes for X", "what did I write about X", "did I ever note Y"). Use when the user wants to surface non-obvious connections across their notes ("find bridges/connections across my notes", "what links X and Y", "show related notes"). Use when the user wants to synthesize a position from their notes ("summarize what I think about X from my notes", "pull together everything I've written on X"). Also use for "index my Apple Notes", tag/folder queries, and "what's connected to X". Do not use for creating reminders, or for non-Apple-Notes note systems. First: is the MCP connected? If apple-notes tools are not available, the server isn't registered yet — do the Setup below before anything else. If tools exist but a search returns "not indexed" or empty, run index-notes first (see Ranking caveats). Setup (walk the user through this — it's the skill's real value) The server reads Apple Notes' SQLite store directly, so the bun binary needs Full Disk Access. Steps, in order: 1. Install bun (if absent): brew install oven-sh/bun/bun 2. Clone + install deps: 3. Grant Full Disk Access to bun. Run which bun, then open System Settings → Privacy & Security → Full Disk Access, click +, and add that exact bun binary path (commonly /opt/homebrew/bin/bun or /usr/local/bin/bun). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/apple-notes-search