Cursor Apple Notes Indexer

Cursor Apple Notes Indexer

By packetnomad GitHub

An MCP app for Cursor that searches and indexes Apple Notes locally

Overview

What is Cursor Apple Notes Indexer?

Cursor Apple Notes Indexer is a Cursor MCP app that allows users to search and create a local index of their Apple Notes, enhancing the note-taking experience.

How to use Cursor Apple Notes Indexer?

To use the app, clone the repository, install the dependencies, and follow the commands in the Command Palette of Cursor to index and search your notes.

Key features of Cursor Apple Notes Indexer?

  • 🔍 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.

Use cases of Cursor Apple Notes Indexer?

  1. Efficiently searching for specific notes in a large collection.
  2. Keeping an up-to-date index of notes for quick access.
  3. Utilizing advanced search features to filter notes by date or folder.

FAQ from Cursor Apple Notes Indexer?

  • Is my data safe?

Yes! All data remains on your local machine and is not sent to external servers.

  • What are the requirements?

You need macOS, Cursor IDE, and Node.js 14+ to run the app.

  • How do I troubleshoot permission issues?

Ensure you allow Cursor to control the Notes app in System Preferences > Security & Privacy > Privacy > Automation.

Content

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

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

No tools information available.
No content found.