What is Mcp Apple Notes Fixed

mcp-apple-notes-fixed is a Model Context Protocol (MCP) server that facilitates semantic search and Retrieval Augmented Generation (RAG) over Apple Notes, allowing AI assistants like Claude to access and reference notes during conversations.

Use cases

Use cases include enhancing productivity by allowing AI assistants to quickly find relevant notes, assisting in research by retrieving information from notes during discussions, and improving organization by indexing and searching through large volumes of notes.

How to use

To use mcp-apple-notes-fixed, clone the repository, install dependencies using Bun, configure the Claude desktop app to recognize the MCP server, and then index your Apple Notes by instructing Claude to do so.

Key features

Key features include semantic search using all-MiniLM-L6-v2 embeddings, full-text search capabilities, vector storage with LanceDB, native integration with Apple Notes via JXA, and fully local execution without the need for API keys.

Where to use

mcp-apple-notes-fixed can be used in personal productivity applications, AI assistant integrations, and any context where users need to retrieve and reference their notes efficiently.

MCP Apple Notes

A Model Context Protocol (MCP) 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 on-device embeddings model
• 📝 Full-text search capabilities
• 📊 Vector storage using LanceDB
• 🤖 MCP-compatible server for AI assistant integration
• 🍎 Native Apple Notes integration via JXA
• 🏃‍♂️ Fully local execution - no API keys needed

Prerequisites

• Bun
• Claude Desktop

Installation

1. Clone the repository:

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

2. Install dependencies:

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:

{
  "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:

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