MCPgee
MCPgee
MCPgeeMCPgee

Apple Notes MCP

v1.0.0•Knowledge & Memory•stable

📇 🏠 🍎 - Semantic search and RAG over Apple Notes with on-device embeddings, full C

aiclaudellmmcpmodel-context
Share:
390
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Apple Notes MCP?

Apple Notes MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 🏠 🍎 - semantic search and rag over apple notes with on-device embeddings, full c

📇 🏠 🍎 - Semantic search and RAG over Apple Notes with on-device embeddings, full C

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Apple Notes semantic search
On-device RAG embeddings
Local-first knowledge management
RafalWilinski

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx mcp-apple-notes

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Apple Notes MCP

MCP Apple Notes is a local-first MCP server that gives AI assistants semantic search and retrieval-augmented generation (RAG) capabilities over your Apple Notes library, using on-device vector embeddings stored in LanceDB. It connects to Apple Notes via JXA (JavaScript for Automation), indexes your notes with embedding models, and exposes both semantic and full-text search tools — all without sending your notes to any external service. Mac users who rely heavily on Apple Notes for personal knowledge management can use this to query their notes conversationally through Claude.

Prerequisites

  • macOS (required — Apple Notes and JXA are macOS-only)
  • Bun runtime installed (https://bun.sh)
  • Claude Desktop installed and configured
  • Apple Notes app with at least some notes to index
1

Clone the repository

Clone the mcp-apple-notes repository to your local machine. This server is not published to npm, so you run it directly from the cloned source.

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

Install dependencies

Install the project dependencies using Bun. The project uses Bun both as the package manager and the runtime.

bun install
3

Configure Claude Desktop

Add the server to your claude_desktop_config.json. Replace YOUR_USER_NAME with your actual macOS username. The server is launched by Bun running the index.ts entry point.

{
  "mcpServers": {
    "apple-notes": {
      "command": "/Users/YOUR_USER_NAME/.bun/bin/bun",
      "args": ["/Users/YOUR_USER_NAME/mcp-apple-notes/index.ts"]
    }
  }
}
4

Restart Claude Desktop

Quit and reopen Claude Desktop so it picks up the new MCP server configuration. The apple-notes server should now appear in the connected servers list.

5

Index your Apple Notes

Ask Claude to index your notes. This reads all notes via JXA, generates vector embeddings, and stores them in LanceDB on your device. Indexing only needs to be done once and can be repeated to pick up new notes.

Apple Notes MCP Examples

Client configuration

Claude Desktop configuration pointing to the locally cloned and Bun-run server. Update the path to match where you cloned the repo.

{
  "mcpServers": {
    "apple-notes": {
      "command": "/Users/YOUR_USER_NAME/.bun/bin/bun",
      "args": ["/Users/YOUR_USER_NAME/mcp-apple-notes/index.ts"]
    }
  }
}

Prompts to try

After indexing, use these prompts to search and retrieve your Apple Notes through Claude.

- "Index my Apple Notes"
- "Search my notes for anything about project deadlines in Q1"
- "Find my notes on machine learning papers I've read"
- "What did I write about my trip to Japan?"
- "Search for notes containing the word 'budget' and summarize them"
- "Find notes I wrote about book recommendations"

Troubleshooting Apple Notes MCP

Claude cannot access Apple Notes — JXA automation permission denied

Open System Settings > Privacy & Security > Automation, and grant permission for Claude (or the Bun process) to control the Notes app. You may also need to grant Full Disk Access for complete access.

Bun command not found in the config

Find the exact path to your Bun binary by running `which bun` in a terminal and use that full path in the config (e.g., /Users/you/.bun/bin/bun). The MCP server process does not inherit your shell PATH.

Server errors after updating notes — search returns stale results

Re-run the indexing step by asking Claude to 'index my Apple Notes' again. The server does not auto-watch for note changes; re-indexing refreshes the LanceDB vector store with new content.

Frequently Asked Questions about Apple Notes MCP

What is Apple Notes MCP?

Apple Notes MCP is a Model Context Protocol (MCP) server that 📇 🏠 🍎 - semantic search and rag over apple notes with on-device embeddings, full c It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Apple Notes MCP?

Follow the installation instructions on the Apple Notes MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Apple Notes MCP?

Apple Notes MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Apple Notes MCP free to use?

Yes, Apple Notes MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Apple Notes MCP Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Apple Notes MCP? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "mcp-apple-notes": { "command": "npx", "args": ["-y", "mcp-apple-notes"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Apple Notes MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides