MCP Apple Notes Fixed

🚀 MCP Apple Notes

An Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) on your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.

✨ Features

• 🔍 Semantic search on the local device using all-MiniLM-L6-v2
• 📝 Full-text search functionality
• 📊 Vector storage using LanceDB
• 🤖 MCP server compatible with AI assistants
• 🍎 Native Apple Notes integration via JXA
• 🏃‍♂️ Fully local execution — no API keys required

📦 Installation

Prerequisites

• Bun
• Claude Desktop

Steps

1. Clone the repository:

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

2. Install the dependencies:

bun install

💻 Usage Examples

Basic Usage

1. Open the Claude desktop application, go to Settings -> Developer -> Edit Configuration.

2. Open the claude_desktop_config.json file and add the following content:

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

⚠️ Important Note

Replace <YOUR_USER_NAME> with your actual username.

3. Restart the Claude desktop application. You should see the following interface:

4. Start by having Claude index your notes. You can say to it: "Index my notes" or "Index my Apple Notes".

🔧 Troubleshooting

View the logs:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# Or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

📋 To-Do List

• [ ] Convert Apple Notes from HTML format to Markdown and embed the content
• [ ] Chunk the source content using a recursive text splitter or Markdown text splitter
• [ ] Add an option to use a custom embedding model
• [ ] More control over the database — clear, custom queries, etc.
• [x] Store notes in Notes via Claude