MCP Apple Notes

🚀 MCP Apple Notes

A Model Context Protocol (MCP) server for semantic search and retrieval of Apple Notes.

🚀 Quick Start

This is a Model Context Protocol (MCP) server designed for semantic search and retrieval of Apple Notes. It enables users to efficiently search and manage their Apple Notes.

✨ Features

• 🔍 Perform semantic search using on-device embedded models.
• 📝 Provide full-text search functionality.
• 💾 Utilize LanceDB for vector storage.
• 🍎 Integrate natively with Apple Notes.

📦 Installation

Prerequisites

• macOS (required for accessing Apple Notes).
• Bun JavaScript runtime environment.

Steps

1. Clone this repository:

git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes

2. Install dependencies:

bun install

💻 Usage Examples

Configuration in Cursor IDE

1. Open Cursor IDE.

2. Go to Settings → Features → MCP.

3. 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/bun with the actual path to your Bun executable (find it using which bun), and replace /path/to/mcp-apple-notes with the actual path to this repository.

4. Restart Cursor IDE.

Using the MCP Server

After configuration, you can use the following tools in conversations with Claude:

• list-notes: List the titles of all Apple Notes.
• index-notes: Index notes for semantic search (perform this first).
• get-note: Retrieve a specific note by title.
• search-notes: Search for notes using semantics or keywords.
• create-note: Create a new note with a specified title and content.

📚 Documentation

Troubleshooting

When encountering issues:

1. Check if the server is running (view the MCP server status in Cursor).
2. Verify that the paths in the configuration are correct.
3. Try running the command directly in the terminal to get error messages.
4. Ensure that Apple Notes are accessible and permissions are granted.

📄 License

This project is licensed under the MIT license.