Cursor Apple Notes Indexer
- ide
An MCP app for Cursor that searches and indexes Apple Notes locally
About
What is Cursor Apple Notes Indexer?
Cursor Apple Notes Indexer is a Cursor MCP (Model Context Protocol) app for macOS that lets you search your Apple Notes directly from the Cursor IDE. It builds a local index of your notes progressively, updates it as you use the app, and stores all data entirely on your machine.
How to use Cursor Apple Notes Indexer?
Clone the repository, open the folder in Cursor, run npm install, and then install the app in Cursor’s MCP panel. Use the Command Palette (Cmd+Shift+P) to run commands: “Apple Notes Indexer: Index Notes” to build your index, “Apple Notes Indexer: Search Notes” to query with optional filters, and “Apple Notes Indexer: View Index” to see statistics.
Key features of Cursor Apple Notes Indexer
- Search Apple Notes without leaving Cursor.
- Progressive indexing that builds and updates over time.
- Live re-indexing to capture latest notes.
- Advanced search with filters and operators.
- All indexed data stored locally for privacy.
Use cases of Cursor Apple Notes Indexer
- Quickly find a note by typing a few keywords from within Cursor.
- Search only in specific Apple Notes folders (e.g., “Work”, “Personal”).
- Filter notes by date range and sort results by date.
- Index your entire notes library once and perform fast, offline searches later.
FAQ from Cursor Apple Notes Indexer
What is the difference between this and Apple’s built‑in Notes search?
Cursor Apple Notes Indexer builds a persistent local index that you can query directly inside Cursor with advanced operators (folder, date range, sorting). Apple’s own search is limited to the Notes app itself.
On which platforms does Cursor Apple Notes Indexer work?
It requires macOS (since it uses the Apple Notes system) and the Cursor IDE. Node.js 14+ is also needed.
How is my privacy handled?
All indexed notes and search queries remain on your local machine. The app never sends data to external servers.
How do I allow Cursor to access Apple Notes?
If you encounter permission issues, go to System Preferences > Security & Privacy > Privacy > Automation and allow Cursor to control the Notes app.
Is Cursor Apple Notes Indexer free to use?
Yes, it is open‑source under the MIT license. No payment or subscription is required.
Details
- Author
- packetnomad
- Category
- ide
- Repository
- packetnomad/cursor-apple-notes-indexer
Cursor Apple Notes Indexer
A Cursor MCP app that allows you to search your Apple Notes and create a local index that builds progressively.
Features
- 🔍 Search Apple Notes: Quickly find your notes without leaving Cursor
- 📇 Progressive Indexing: The app builds and updates its index as you use it
- 🔄 Live Updates: Re-index to capture your latest notes
- 🔎 Advanced Search: Use filters and operators for precise searching
- 🗄️ Local Storage: All indexed data is stored locally on your machine
Installation
1. Clone this repository
2. Open the folder in Cursor
3. Run npm install to install dependencies
4. Install the app in Cursor's MCP panel
Usage
Indexing Notes
Before searching, you need to build the index:
1. Open the Command Palette in Cursor (Cmd+Shift+P)
2. Type "Apple Notes Indexer: Index Notes"
3. Wait for the indexing process to complete
Searching Notes
1. Open the Command Palette in Cursor (Cmd+Shift+P)
2. Type "Apple Notes Indexer: Search Notes"
3. Enter your search query
4. Browse through the results
Advanced Search
You can use advanced search operators in your queries:
- folder:"Personal" - Search only in the "Personal" folder
- date:"2023-01-01 to 2023-12-31" - Search for notes within a date range
- sort:dateNewest - Sort results by date (newest first)
Combined example:
meeting notes folder:"Work" date:"2023-01-01 to 2023-12-31" sort:dateNewest
View Index Status
1. Open the Command Palette in Cursor (Cmd+Shift+P)
2. Type "Apple Notes Indexer: View Index"
3. See statistics about your indexed notes
Requirements
- macOS (since it uses Apple Notes)
- Cursor IDE
- Node.js 14+
Privacy
All data remains on your local machine. The app does not send your notes or search queries to any external servers.
Troubleshooting
If you encounter permission issues when accessing Apple Notes, make sure to:
1. Open System Preferences > Security & Privacy > Privacy > Automation
2. Allow Cursor to control the Notes app
Development
Building
npm install
npm run build
Contributing
Pull requests are welcome! Please feel free to contribute to this project.
License
MIT