Agent skill · Backend & API

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.

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill apple-notes-search --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 8 KB
Bundled scripts: none
Declared author: connerkward
Path: skills/apple-notes-search/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# 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 creat

What's inside
Steps it walks through
  1. When to Use This Skill
  2. First: is the MCP connected?
  3. Setup (walk the user through this — it's the skill's real value)
  4. Tool map — which tool for which job
  5. Ranking caveats (state these when results look off)
  6. Limitations
  7. Credits
Commands it runs
git clone https://github.com/connerkward/mcp-apple-notes
cd mcp-apple-notes
git checkout <reviewed-tag-or-commit>
bun install
More from agentic-awesome-skills
All skills →
About this skill
What does the apple-notes-search skill do?

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.

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill apple-notes-search --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going