mcpField
C
Cursor Apple Notes Indexer

Cursor Apple Notes Indexer

github.com/packetnomadIDEs & Editors0Updated 86w ago
Repository

About Cursor Apple Notes Indexer

An MCP client app for Cursor IDE enabling search and indexing of Apple Notes locally. Users quickly find notes without leaving the editor.

Key features

  1. 01Search Apple Notes
  2. 02Progressive local indexing
  3. 03Advanced search filters
  4. 04Live index updates
  5. 05Local data storage

Use cases

  1. 01Find work notes while coding
  2. 02Search by folder and date range
  3. 03Keep index current with new notes
  4. 04View index statistics

MCP support

The app functions as an MCP client within Cursor, providing Apple Notes search directly in the IDE.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.