mcpField
M
MCP Apple Notes

MCP Apple Notes

Local
rwilinski.aiMemory & Knowledge417Updated 97w ago
RepositoryVisit website

About MCP Apple Notes

MCP Apple Notes is an MCP server that provides semantic search and RAG over Apple Notes, letting Claude and other AI assistants reference personal notes during conversations. It targets macOS users of the Claude desktop app and runs its embedding model on-device without API keys.

Key features

  1. 01On-device semantic search using all-MiniLM-L6-v2 embeddings
  2. 02Full-text search over notes
  3. 03Vector storage with LanceDB
  4. 04Native Apple Notes access through JXA
  5. 05Fully local execution without API keys

Use cases

  1. 01Retrieving personal note content during Claude conversations
  2. 02Letting an AI assistant answer questions based on notes
  3. 03Indexing Apple Notes and saving new notes through chat

MCP support

The project is an MCP server that exposes note search and indexing capabilities to MCP clients such as Claude Desktop.

#ai#mcp#claude#rag#llm#model-context

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Apple Notes

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.

MCP Apple Notes

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

Installation

  1. Clone the repository:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. Install dependencies:
bun install

Usage

  1. Open Claude desktop app and go to Settings -> Developer -> Edit Config

Claude Desktop Settings

  1. 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.

  1. Restart Claude desktop app. You should see this:

Claude MCP Connection Status

  1. 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.
  • Storing notes in Notes via Claude

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.