MCP Apple Notes

What is MCP Apple Notes?

MCP Apple Notes is a Model Context Protocol server that enables semantic search and retrieval over Apple Notes using on-device embeddings and LanceDB vector storage, integrated natively with macOS.

How to use MCP Apple Notes?

Configure MCP Apple Notes in Cursor IDE by adding a new command-type MCP server with the path to Bun and the index.ts file. After configuration, use the provided tools (list-notes, index-notes, get-note, search-notes, create-note) to interact with Apple Notes through Claude.

Key features of MCP Apple Notes

• Semantic search using an on-device embeddings model
• Full-text search capabilities
• Vector storage with LanceDB
• Native Apple Notes integration

Use cases of MCP Apple Notes

• Search your Apple Notes semantically using natural language queries
• Retrieve a specific note by its title
• List all note titles in your Apple Notes database
• Create new notes directly from a chat conversation

FAQ from MCP Apple Notes

What are the prerequisites for running MCP Apple Notes?

You need a macOS system and the Bun JavaScript runtime installed.

How do I start indexing my notes?

Use the index-notes tool after configuring the server to index your notes for semantic search.

What tools does the server expose?

The server provides five tools: list-notes, index-notes, get-note, search-notes, and create-note.

How can I verify the server is running correctly?

Check the MCP server status in Cursor IDE and try running the command directly in the terminal to see any error messages.

What should I do if I encounter permission issues?

Ensure Apple Notes is accessible and that you have granted the necessary permissions to the server.