Back to search
mcp-apple-notes
MCP serverGitHub
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
Markdown
[](/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)
- # MCP Apple Notes
- 
- 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.
- 
- ## Features
- - 🔍 Semantic search over Apple Notes using [`all-MiniLM-L6-v2`](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) on-device embeddings model
- - 📝 Full-text search capabilities
- - 📊 Vector storage using [LanceDB](https://lancedb.github.io/lancedb/)
- - 🤖 MCP-compatible server for AI assistant integration
- - 🍎 Native Apple Notes integration via JXA
- - 🏃♂️ Fully local execution - no API keys needed
- ## Prerequisites
- - [Bun](https://bun.sh/docs/installation)
- - [Claude Desktop](https://claude.ai/download)
- ## Installation
- 1. Clone the repository:
- ```bash
- git clone https://github.com/RafalWilinski/mcp-apple-notes
- cd mcp-apple-notes
- ```
- 2. Install dependencies:
- ```bash
- bun install
- ```
- ## Usage
- 1. Open Claude desktop app and go to Settings -> Developer -> Edit Config
- 
- 2. Open the `claude_desktop_config.json` and add the following entry:
- ```json
- {
- "mcpServers": {
- "local-machine": {
- "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
- "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
- }
- }
- }
- ```
- Important: Replace `<YOUR_USER_NAME>` with your actual username.
- 3. Restart Claude desktop app. You should see this:
- 
- 4. Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".
- ## Troubleshooting
- To see logs:
- ```bash
- tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
- # or
- tail -n 50 -f ~/Library/Logs/Claude/mcp.log
- ```
- ## Todos
- - [ ] Apple notes are returned in the HTML format. We should turn them to Markdown and embed that
- - [ ] Chunk source content using recursive text splitter or markdown text splitter
- - [ ] Add an option to use custom embeddings model
- - [ ] More control over DB - purge, custom queries, etc.
- - [x] Storing notes in Notes via Claude
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.