Overview

MCP Apple Notes

Description:
A server enabling semantic search and conversation with Apple Notes via Claude assistant

Category: Personal Knowledge Management

Overview:
This server allows Claude to search and reference your Apple Notes during conversations using semantic search with on-device embeddings. It runs completely locally without requiring any API keys.

Key features:

Semantic search using all-MiniLM-L6-v2 embeddings
Full-text search capabilities
Vector storage via LanceDB
Native Apple Notes integration through JXA
Local execution without external dependencies

Prerequisites:

Bun
Claude Desktop
Apple Notes

Setup:

Clone and install dependencies

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

Configure Claude Desktop by adding this to claude_desktop_config.json:

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

Usage:

After setup, restart Claude Desktop
Initialize by asking Claude to "Index my notes" or "Index my Apple Notes"
Start querying your notes through natural conversation

Troubleshooting: View logs with:

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

Current Limitations:

Notes are returned in HTML format (Markdown conversion planned)
Limited DB control options
Basic embedding model configuration