Apple Notes

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

typescript

343

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run an MCP server locally to search and reference your Apple Notes inside an AI assistant. This server runs entirely on your machine, using on-device embeddings and local indexing to provide fast, private retrieval during conversations.

How to use

You operate the MCP server from your local environment and connect it to your AI assistant client. The server exposes a local endpoint that your client can query for semantic search over your Apple Notes and for full-text search. To start, index your notes so the assistant can reference them during chats. Then you can ask for notes by topic, keyword, or content, and the assistant will retrieve relevant passages from your Apple Notes.

How to install

Prerequisites you need before starting:

Bun is installed on your system
Claude Desktop is installed and configured

Step by step commands you should run:

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

bun install

Run and configure the MCP server locally

You will start the MCP server as a local process and tell Claude Desktop how to launch it. The following configuration runs the MCP server from a local bun executable and the TypeScript entry script.

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

Index your notes and start using

After Claude Desktop restarts, you should be able to trigger the indexing flow by asking Claude to index your notes. Say something like: “Index my notes” or “Index my Apple Notes”. The MCP server will index your notes locally and populate the vector store for semantic search.

Troubleshooting

If you encounter issues, check the logs to understand startup problems or indexing errors. Tail the logs with one of these commands to watch in real time:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local_machine.log

or

tail -n 50 -f ~/Library/Logs/Claude/mcp.log