MCP Apple Notes logo

MCP Apple Notes

by Dingzeefs

MCP Apple Notes is a Model Context Protocol server that enables semantic search and retrieval over your Apple Notes. It integrates with Cursor IDE to allow you to use your notes in conversations with Claude.

View on GitHub

Last updated: N/A

What is MCP Apple Notes?

MCP Apple Notes is a server that allows you to semantically search and retrieve information from your Apple Notes using a Model Context Protocol. It uses on-device embeddings and LanceDB for vector storage.

How to use MCP Apple Notes?

First, clone the repository and install dependencies using Bun. Then, configure the server in Cursor IDE by adding a new MCP server with the provided command, ensuring the paths to Bun and the repository are correct. After restarting Cursor IDE, you can use the provided tools (list-notes, index-notes, get-note, search-notes, create-note) in your conversations with Claude.

Key features of MCP Apple Notes

  • Semantic search using on-device embeddings model

  • Full-text search capabilities

  • Vector storage with LanceDB

  • Native Apple Notes integration

Use cases of MCP Apple Notes

  • Quickly find relevant information within your Apple Notes during conversations with Claude

  • Create new notes directly from your conversations

  • List and retrieve notes by title

  • Index notes for efficient semantic search

FAQ from MCP Apple Notes

How do I check if the server is running?

Check the MCP server status in Cursor IDE.

What if the server isn't working?

Verify that the paths in your MCP server configuration are correct. Try running the command directly in your terminal to see any error messages. Make sure Apple Notes is accessible and permissions are granted.

What is Bun?

Bun is a JavaScript runtime required to run the server.

Why do I need macOS?

macOS is required for Apple Notes integration.

What is LanceDB?

LanceDB is used for vector storage, enabling efficient semantic search.