菜单
Runs on-device semantic plus keyword search and Swanson-ABC connection-discovery over the user's Apple Notes via the apple-notes MCP. Use when finding, recalling, synthesizing, or bridging notes on macOS. Not for Obsidian, SiYuan, Notion, or Apple Reminders.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Kayforkind/skill-slice --skill apple-notes-search命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Open a creative mind on the current context and invent a leap the user did not know to ask for — a feature, protocol, CLI, demo, architecture, product move, prose, experiment, or visual. Use when they run /awe-me or /inspire-me, say “awe me” or “inspire me”, want surprise, adjacent possible, make-strange, or are stuck recognizing instead of seeing. Not a brainstorm list. Not /better (quality pass). Not a feasibility grill.
Design, power, run, and analyze statistically valid A/B/N product experiments (sample size, duration, SRM, sequential monitoring, multiple comparisons). Use when pre-registering a test or reading out a controlled split. Not for event instrumentation, funnel diagnosis, wandb ML tracking (weights-and-biases), MVP smoke tests (mvp-scoping-and-risk-test), or RICE scoring (feature-prioritization-frameworks).
Runs Astropy BoxLeastSquares (BLS) on photometric time series: autopower/power grids, depth SNR, odd/even vetting. Use for periodic box-shaped transit dips or eclipsing binaries (Kovács 2002). Not for Transit Least Squares limb-darkened templates, Lomb-Scargle sinusoids, or non-photometric series. API: astropy.timeseries.BoxLeastSquares (Astropy 8).
正在显示 SKILL.md
| name | apple-notes-search |
| description | Runs on-device semantic plus keyword search and Swanson-ABC connection-discovery over the user's Apple Notes via the apple-notes MCP. Use when finding, recalling, synthesizing, or bridging notes on macOS. Not for Obsidian, SiYuan, Notion, or Apple Reminders. |
| version | 1.0.1 |
| risk | critical |
| source | community |
| source_repo | connerkward/mcp-apple-notes |
| source_type | community |
| date_added | 2026-06-16 |
| tags | ["apple-notes","search","mcp","macos","semantic-search","knowledge"] |
| tools | ["claude-code"] |
| license | MIT |
| license_source | https://github.com/connerkward/mcp-apple-notes/blob/main/LICENSE |
| plugin | {"targets":{"codex":"blocked","claude":"blocked"},"setup":{"type":"manual","summary":"Requires third-party MCP setup and macOS Full Disk Access; keep out of plugin-safe bundles.","docs":"SKILL.md"}} |
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).
bun installed (brew install oven-sh/bun/bun).bun binary.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.brew install oven-sh/bun/bun
b. Clone + install deps:
git clone https://github.com/connerkward/mcp-apple-notes
cd mcp-apple-notes
git checkout <reviewed-tag-or-commit>
bun install
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). Without this the server cannot read NoteStore.sqlite and every call fails with a permissions error.
d. (pick the user's client):
claude mcp add apple-notes -- bun /absolute/path/to/mcp-apple-notes/index.ts --stdioclaude_desktop_config.json:
{ "mcpServers": { "apple-notes": {
"command": "/Users/<you>/.bun/bin/bun",
"args": ["/Users/<you>/mcp-apple-notes/index.ts", "--stdio"] } } }
/plugin marketplace add connerkward/ckw-skills then /plugin install apple-notes@connerkward.
e. Restart the client, then tell the user to ask "Index my Apple Notes" (or call index-notes). First index of ~1,800 notes takes a few seconds.index-notes: First run, or to force a rebuild. Background job with live progress.search-notes: Default search. Hybrid semantic + BM25, re-ranked. Optional folder, modifiedAfter, modifiedBefore. "What did I write about X."find-notes: Exact substring match (like the Apple Notes search box). Use when the user wants a literal string, not meaning. Optional folder, date range.get-note: Fetch one full note by title (fuzzy fallback).list-notes: Notes by recency. Optional folder, date range, limit.list-folders: All folders + note counts.list-tags / search-by-tag: #hashtag inventory / notes carrying a given tag.related-notes: Notes related to a given one via shared tags, [[wikilinks]], and vector similarity. "Show me related notes."bridge-notes: Swanson-ABC bridges — non-obvious connections: pairs (A, C) not directly similar but both strongly tied to a shared intermediary B. "Find non-obvious connections across my notes." Optional folder, limit. No LLM.feed: Ranked evidence-first connection stream (bridges + abstraction pairs + entity threads) as JSON. Optional limit.entity-notes / list-entities: "Where else do I talk about Mercedes?" Entity chips → notes by mention weight. Needs the optional entity graph db (~/.mcp-apple-notes/layered_graph.db); if absent these report how to generate it.get-tables: Pull pipe/tab tables out of a note.create-note / update-note: Create or edit a note.check-changes: Did notes change since last index? (does not trigger re-index)index-health: Sync status, last-indexed time, note count. Run this if results seem stale.GET /api/synthesize?q= at http://localhost:3741/ when run with bun index.ts), which writes a grounded answer with inline [n] citations back to source notes.index-notes.score = RRF(vector, BM25) × title_boost × recency_factor.recent, latest, today) auto-shift to a 1-day recency half-life at 70% weight; normal queries keep relevance primary (90-day half-life, 10%).SYNTH_BASE_URL=http://localhost:1234/v1 SYNTH_MODEL=<model> OPENAI_API_KEY=local, notes stay on-device) or real OpenAI (funded OPENAI_API_KEY, defaults to gpt-4o-mini). Everything else — embeddings, search, BM25, clustering, bridges, entities — is on-device.index-health. If it returns sync status, last-indexed time, and note count, the MCP is connected.index-notes and check index-health again.bun index.ts), verify the endpoint with curl "http://localhost:3741/api/synthesize?q=test" and check for a grounded answer with inline citations.