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:
- Install dependencies:
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/bun
with the actual path to your Bun executable (find it usingwhich bun
) and/path/to/mcp-apple-notes
with 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
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.Last updated -8TypeScript
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Apple Reminders on macOS, allowing users to view lists, retrieve, create, complete, and delete reminders through natural language.Last updated -55TypeScript
- -securityFlicense-qualityA Model Context Protocol server that extends AI capabilities through tools for remote control, note-taking, email operations, and knowledge search.Last updated -Python
- AsecurityAlicenseAqualityA Model Context Protocol server that provides AI coding assistants with direct access to Apple's Developer Documentation, enabling seamless lookup of frameworks, symbols, and detailed API references.Last updated -4198JavaScriptMIT License