Mcp Apple Notes
What is Mcp Apple Notes
mcp-apple-notes is an MCP server designed for semantic search and retrieval of Apple Notes, integrating seamlessly with Cursor IDE.
Use cases
Use cases include organizing personal notes, conducting semantic searches for specific information, retrieving notes by title, and creating new notes directly through the MCP server.
How to use
To use mcp-apple-notes, clone the repository, install dependencies using Bun, configure it in Cursor IDE, and then utilize various commands like listing, indexing, retrieving, searching, and creating notes.
Key features
Key features include semantic search with on-device embeddings, full-text search capabilities, vector storage with LanceDB, and native integration with Apple Notes.
Where to use
mcp-apple-notes is primarily used in personal productivity, note-taking applications, and any environment where efficient retrieval of information from Apple Notes is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Apple Notes
mcp-apple-notes is an MCP server designed for semantic search and retrieval of Apple Notes, integrating seamlessly with Cursor IDE.
Use cases
Use cases include organizing personal notes, conducting semantic searches for specific information, retrieving notes by title, and creating new notes directly through the MCP server.
How to use
To use mcp-apple-notes, clone the repository, install dependencies using Bun, configure it in Cursor IDE, and then utilize various commands like listing, indexing, retrieving, searching, and creating notes.
Key features
Key features include semantic search with on-device embeddings, full-text search capabilities, vector storage with LanceDB, and native integration with Apple Notes.
Where to use
mcp-apple-notes is primarily used in personal productivity, note-taking applications, and any environment where efficient retrieval of information from Apple Notes is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
