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:

1. Clone and install dependencies

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

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