Apple Notes MCP Server

Talk with your Apple Notes

Local serverstdioGo

What is the Apple Notes MCP server?

Apple notes mcp server lets Claude, Cursor and other MCP clients work with Apple Notes directly. Talk with your Apple Notes.

What Apple Notes does

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.

Key capabilities

  • 🔍 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

Installing the apple notes mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Requirements

Where it fits

File and storage servers are what separate an assistant that talks about your documents from one that actually works with them. Apple Notes sits in that group. Worth comparing against the other file systems servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • Written in Go.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the apple notes mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Apple Notes MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Frequently asked questions

It connects Apple Notes to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Apple Notes directly.