mcp-apple-notes

Method 1: Install from source (recommended)

By cloning the repository locally, you can inspect the source code and know exactly what is executing on your machine.

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && bun install

{ "mcpServers": { "apple-notes": { "command": "bun", "args": ](https://github.com/Dan8Oren/mcp-apple-notes/blob/HEAD/index.ts)["run", "/path/to/mcp-apple-notes/index.ts"] } } }

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && npm install

Then add the server to your MCP client config. Replace/path/to/mcp-apple-noteswith where you cloned the repo:

{ "mcpServers": { "apple-notes": { "command": "npx", "args": ["tsx", "/path/to/mcp-apple-notes/index.ts"] } } }

Tip:Want to try it without risk? Enableread-only modeto block all write operations while you explore.
"env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }

{ "mcpServers": { "apple-notes": { "command": "npx", "args": ["-y", "@dan8oren/mcp-apple-notes"] } } }

After setup, restart your client and ask your AI assistant to"index my notes"to get started.
- OpenSettings → Developer → Edit Config
- Paste your chosen JSON config intoclaude_desktop_config.json
- Restart Claude Desktop

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-apple-notes.log

# npm version: claude mcp add apple-notes npx -- -y @dan8oren/mcp-apple-notes # or from source: claude mcp add apple-notes npx -- tsx /path/to/mcp-apple-notes/index.ts

Add the JSON config to~/.cursor/mcp.json(global) or.cursor/mcp.jsonin your project root.

Add the JSON config to~/.windsurf/mcp.json.

Every Apple Notes operation is aJXAcall you can inspect inindex.ts. No network requests, no background syncing — just local scripting bridge calls.

{ "mcpServers": { "apple-notes": { "command": "npx", "args": ["-y", "@dan8oren/mcp-apple-notes"], "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" } } } }

When enabled, only these tools are available:index-notes,list-folders,list-notes,search-notes,get-note.

Enable verbose logging to see every JXA call before it executes (logged to stderr):

CLI flag— add--verboseto your MCP client config args:

{ "mcpServers": { "apple-notes": { "command": "npx", "args": ["--verbose", "-y", "@dan8oren/mcp-apple-notes"] } } }

Environment variable— for clients that supportenv:

{ "mcpServers": { "apple-notes": { "command": "npx", "args": ["-y", "@dan8oren/mcp-apple-notes"], "env": { "MCP_APPLE_NOTES_VERBOSE": "1" } } } }

All operations go through Apple's JXA scripting bridge (Application('Notes')). No direct file system access, no network calls. Thedeleteoperation is non-permanent — notes go to Recently Deleted and can be recovered within 30 days.

Tool responses are JSON objects in a consistent envelope:

- Success:{ "ok": true, "data": ... }
- Error:{ "ok": false, "error": { "type": "...", "message": "..." } }

Most note-oriented responses now include the stable Apple Notesidso clients can track notes safely across renames and moves.

Bug reports, ideas, questions, and showcases all have a home — please use the channel that fits:

- 🐛Found a bug?→Open an issue
- 💡Have a feature idea?→Start a thread in Ideas
- ❓Need help with setup or integration?→Ask in Q&A
- 🛠Built something cool with it?→Share in Show and tell
- 📣Watch for updates→Announcements

Originally based onRafalWilinski/mcp-apple-notes.

An MCP server for document ingestion, chunking, semantic search, and note management.