mcp-apple-notes

MCP.Pizza Chef: RafalWilinski

Searching by meaning rather than exact wording was the idea here: it reads your notes once, builds a private index on your own Mac, then answers questions about what you wrote. It can also save new notes back. Nothing leaves your computer and no paid key is needed. The catch is age — the code has not changed since December 2024, reported problems sit unanswered, and the author has never pointed anyone to a replacement. Treat it as abandoned.

Unmaintained · no commits since December 2024; no successor named

Files/PDF

Notes

Use This MCP server To

Search my notes by meaning instead of exact wording Pull up old notes about a trip I once planned Ask what I wrote down in a meeting last year Save a summary from a chat as a new Apple Note Index my whole notes library once and search it offline

README

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.

MCP Apple Notes

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:

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

Install dependencies:

bun install

Usage

Open Claude desktop app and go to Settings -> Developer -> Edit Config

Claude Desktop Settings

Open the claude_desktop_config.json and add the following entry:

mcp-apple-notes FAQ

Is this project still maintained?

No. The last change to the code was December 2024, more than a year and a half ago, and the author has not named a successor project. Open problems, including notes arriving as raw web markup, were listed as unfinished and remain that way.

Does it work on Windows?

No. It reads the Apple Notes app directly, so it is Mac only.

Do I need an account or a paid key?

No. The search index and the model that powers it both run on your own Mac, so nothing is sent to an outside service.

Which apps does it work in?

It was written for Claude Desktop and is configured through that app's settings file.

Can I use this to find an old note when I cannot remember its title?

That was exactly the point — you describe roughly what the note was about and it finds the closest matches. Just be aware you are running unmaintained code.

How hard is setup?

You download the project, install a runtime called Bun, paste a few lines into Claude Desktop's settings file, then ask Claude to index your notes.