MCP Apple Notes
A Model Context Protocol (MCP) server for semantic search and retrieval over Apple Notes.
Features
- 🔍 Semantic search using on-device embeddings model
- 📝 Full-text search capabilities
- 💾 Vector storage with LanceDB
- 🍎 Native Apple Notes integration
Prerequisites
- macOS (required for Apple Notes integration)
- Bun JavaScript runtime
Installation
- Clone this repository:
git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes
- Install dependencies:
bun install
Usage
Configuring in Cursor IDE
-
Open Cursor IDE
-
Go to Settings → Features → MCP
-
Add a new MCP server with the following configuration:
- Name: Apple Notes
- Type: command
- Command:
/path/to/bun /path/to/mcp-apple-notes/index.ts
Replace
/path/to/bunwith the actual path to your Bun executable (find it usingwhich bun) and/path/to/mcp-apple-noteswith the actual path to this repository. -
Restart Cursor IDE
Using the MCP Server
Once configured, you can use the following tools in your conversations with Claude:
- list-notes: Lists all your Apple Notes titles
- index-notes: Indexes your notes for semantic search (do this first)
- get-note: Retrieves a specific note by title
- search-notes: Searches your notes using semantic or keyword search
- create-note: Creates a new note with specified title and content
Troubleshooting
If you encounter issues:
- Check that the server is running by looking at the MCP server status in Cursor
- Verify that the paths in your MCP server configuration are correct
- Try running the command directly in your terminal to see any error messages
- Make sure Apple Notes is accessible and permissions are granted
License
MIT