What is MCP Apple Notes?

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

How to use MCP Apple Notes?

1. Clone the repository and install dependencies using Bun.
2. Configure Claude Desktop to connect to the MCP server by adding the server details in the config file.
3. Restart Claude and ask it to index your Apple Notes using commands like "Index my notes".

Key features of MCP Apple Notes?

• Semantic search over Apple Notes using on-device embeddings model (all-MiniLM-L6-v2)
• 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

Use cases of MCP Apple Notes?

1. Enhancing AI assistant interactions by referencing personal notes
2. Conducting semantic searches across notes
3. Enabling Retrieval-Augmented Generation (RAG) with Apple Notes

FAQ from MCP Apple Notes?

• Do I need special permissions to access Apple Notes?

The app uses JXA (JavaScript for Automation) for native integration, requiring appropriate permissions.

• Is the data stored locally?

Yes, all data processing and storage is local.

• What is the advantage of using this over native Apple Notes search?

It provides semantic search and AI integration capabilities beyond basic search functionalities.

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//.bun/bin/bun", "args": ["/Users//apple-notes-mcp/index.ts"] } } } ``` Important: Replace `` with your actual username. 3. Restart Claude desktop app. You should see this: ![Claude MCP Connection Status](./images/verify_installation.png) 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