MCP Apple Notes logo

MCP Apple Notes

by RafalWilinski

MCP Apple Notes is a Model Context Protocol server that enables semantic search and Retrieval Augmented Generation (RAG) over your Apple Notes. It allows AI assistants like Claude to search and reference your notes during conversations.

View on GitHub

Last updated: N/A

What is MCP Apple Notes?

MCP Apple Notes is a server that implements the Model Context Protocol (MCP) to allow AI assistants like Claude to access and search your Apple Notes. It uses semantic search and RAG to provide relevant information from your notes to the AI assistant during conversations.

How to use MCP Apple Notes?

To use MCP Apple Notes, you need to install Bun and Claude Desktop. Then, clone the repository, install dependencies, and configure Claude Desktop to connect to the MCP server. Finally, start the server and ask Claude to index your notes.

Key features of MCP Apple Notes

  • Semantic search over Apple Notes

  • Full-text search capabilities

  • Vector storage using LanceDB

  • MCP-compatible server for AI assistant integration

  • Native Apple Notes integration via JXA

  • Fully local execution

Use cases of MCP Apple Notes

  • Allowing AI assistants to answer questions based on your notes

  • Referencing specific notes during conversations with AI assistants

  • Using AI to summarize and analyze your notes

  • Creating a knowledge base from your Apple Notes

  • Improving the accuracy and relevance of AI assistant responses

FAQ from MCP Apple Notes

What is MCP?

MCP stands for Model Context Protocol. It's a protocol that allows AI models to access external data sources.

What is RAG?

RAG is Retrieval Augmented Generation. It's a technique that combines information retrieval with text generation to improve the performance of AI models.

Do I need an API key?

No, MCP Apple Notes runs locally and does not require any API keys.

What embeddings model is used?

The all-MiniLM-L6-v2 embeddings model is used for semantic search.

Where are the logs stored?

Logs are stored in ~/Library/Logs/Claude/mcp-server-local-machine.log or ~/Library/Logs/Claude/mcp.log.