Skip to content
Back to search

mcp-apple-notes

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rafalwilinski--mcp-apple-notes/badge.svg)](/listings/rafalwilinski--mcp-apple-notes)

HTML

<a href="/listings/rafalwilinski--mcp-apple-notes"><img src="/api/listings/rafalwilinski--mcp-apple-notes/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Clone the repository:

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. Install dependencies:

bun install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 81 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MCP Apple Notes
  2. ![MCP Apple Notes](./images/logo.png)
  3. A [Model Context Protocol (MCP)](https://www.anthropic.com/news/model-context-protocol) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.
  4. ![MCP Apple Notes](./images/demo.png)
  5. ## Features
  6. - 🔍 Semantic search over Apple Notes using [`all-MiniLM-L6-v2`](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) on-device embeddings model
  7. - 📝 Full-text search capabilities
  8. - 📊 Vector storage using [LanceDB](https://lancedb.github.io/lancedb/)
  9. - 🤖 MCP-compatible server for AI assistant integration
  10. - 🍎 Native Apple Notes integration via JXA
  11. - 🏃‍♂️ Fully local execution - no API keys needed
  12. ## Prerequisites
  13. - [Bun](https://bun.sh/docs/installation)
  14. - [Claude Desktop](https://claude.ai/download)
  15. ## Installation
  16. 1. Clone the repository:
  17. ```bash
  18. git clone https://github.com/RafalWilinski/mcp-apple-notes
  19. cd mcp-apple-notes
  20. ```
  21. 2. Install dependencies:
  22. ```bash
  23. bun install
  24. ```
  25. ## Usage
  26. 1. Open Claude desktop app and go to Settings -> Developer -> Edit Config
  27. ![Claude Desktop Settings](./images/desktop_settings.png)
  28. 2. Open the `claude_desktop_config.json` and add the following entry:
  29. ```json
  30. {
  31. "mcpServers": {
  32. "local-machine": {
  33. "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
  34. "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
  35. }
  36. }
  37. }
  38. ```
  39. Important: Replace `<YOUR_USER_NAME>` with your actual username.
  40. 3. Restart Claude desktop app. You should see this:
  41. ![Claude MCP Connection Status](./images/verify_installation.png)
  42. 4. Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".
  43. ## Troubleshooting
  44. To see logs:
  45. ```bash
  46. tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
  47. # or
  48. tail -n 50 -f ~/Library/Logs/Claude/mcp.log
  49. ```
  50. ## Todos
  51. - [ ] Apple notes are returned in the HTML format. We should turn them to Markdown and embed that
  52. - [ ] Chunk source content using recursive text splitter or markdown text splitter
  53. - [ ] Add an option to use custom embeddings model
  54. - [ ] More control over DB - purge, custom queries, etc.
  55. - [x] Storing notes in Notes via Claude

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.