Apple Notes MCP Server

Warning

This project is still considered under development (pre-alpha). There might be future changes to the data schema. Use with caution - you may need to reindex your notes after updates.

Installation

bun install

Usage

1. Open Claude Desktop
2. Settings > Developer > Edit Config
3. Open claude_desktop_config.json and add the following entry:

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

Alternatively, bun run scripts/print-mcp-config.ts to get the output in terminal.

4. Quit and start Claude Desktop. Under 'Search and Tools', you should see 'Apple Notes'.

5. Prompt Claude to index your notes and provide a folder: "Index my Apple Notes in folder ____". If you do not provide a folder, it will probably index the main 'Notes' folder.

Development

For interactive debugging with the MCP inspector:

bun run dev

The inspector wraps the server with @modelcontextprotocol/inspector, which gives you a local web UI to test the tools.

Data storage and maintenance

• LanceDB tables live in ~/.mcp-apple-notes/data.

• Re-run index_notes after you update notes so that embeddings and text stay fresh.

• To start over, purge the database:

  bun run purge-db

  The command removes the ~/.mcp-apple-notes directory; re-index afterwards.

Credits

• This project is based on and adapted from RafalWilinski/mcp-apple-notes.