MCP Apple Notes

# Apple Notes MCP Server - Claude Code Setup ## Quick Setup for Claude Code ### 1. Grant AppleScript Permissions (Required) 1. Open **System Settings** → **Privacy & Security** → **Automation** 2. Find your terminal app (Terminal, iTerm, or Claude Code) in the list 3. Enable **"Notes"** access for your terminal app 4. Also go to **Accessibility** → Add your terminal app → Enable **Full Disk Access** ### 2. Install to Claude Code ```bash claude mcp add --scope user --transport stdio apple-notes -- \ ~/.bun/bin/bun /Users/gsarti/Documents/projects/mcps/mcp-apple-notes/index.ts ``` ### 3. Index Your Notes (First Time Only) Ask Claude: "Index my Apple Notes" This will build a vector database of your notes for semantic search. This can take a few minutes if you have many notes. ### 4. Verify Ask Claude: - "Search my notes for 'project plan'" - "Find notes about [topic]" - "What notes do I have about [keyword]?" ## Troubleshooting **Permission Denied:** - Go to System Settings → Privacy & Security → Automation - Ensure your terminal app has "Notes" access enabled **No Results Found:** - Make sure you've indexed your notes first (ask Claude to "Index my Apple Notes") ## Uninstall ```bash claude mcp remove apple-notes ``` ## How It Works - Uses on-device embeddings model (`all-MiniLM-L6-v2`) for semantic search - Vector database stored locally using LanceDB - Fully local - no API keys required - Accesses Apple Notes via JXA (JavaScript for Automation)