Integrations
Enables semantic search and RAG over Apple Notes, allowing AI assistants to search and reference your Apple Notes during conversations
MCP Apple Notes
A Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.
Features
- 🔍 Semantic search over Apple Notes using
all-MiniLM-L6-v2
on-device embeddings model - 📝 Full-text search capabilities
- 📊 Vector storage using LanceDB
- 🤖 MCP-compatible server for AI assistant integration
- 🍎 Native Apple Notes integration via JXA
- 🏃♂️ Fully local execution - no API keys needed
Prerequisites
Installation
- Clone the repository:
- Install dependencies:
Usage
- Open Claude desktop app and go to Settings -> Developer -> Edit Config
- Open the
claude_desktop_config.json
and add the following entry:
Important: Replace <YOUR_USER_NAME>
with your actual username.
- Restart Claude desktop app. You should see this:
- Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".
Troubleshooting
To see logs:
Todos
- Apple notes are returned in the HTML format. We should turn them to Markdown and embed that
- Chunk source content using recursive text splitter or markdown text splitter
- Add an option to use custom embeddings model
- More control over DB - purge, custom queries, etc.
- Storing notes in Notes via Claude
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 RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.
Related Resources
Related MCP Servers
- -securityFlicense-qualityA 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.Last updated -TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with the HackMD API for managing notes, including creating, reading, updating, and deleting notes.Last updated -124020TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that allows AI assistants like Claude to read notes from the Bear note-taking app in a safe, read-only mode.Last updated -2JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to search and access information stored in Kibela, supporting note search, retrieval, creation and updating.Last updated -61079TypeScriptMIT License