MCP Apple Notes
@RafalWilinski
About MCP Apple Notes
Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"fraud": {
"command": "cmd",
"args": []
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Apple Notes?
MCP Apple Notes is a Model Context Protocol (MCP) 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 Apple Notes during conversations.
How to use MCP Apple Notes?
Install Bun and Claude Desktop, clone the repository, and run bun install. Then configure the claude_desktop_config.json file with the server command pointing to index.ts. Restart Claude Desktop and ask it to index your notes (e.g., "Index my notes").
Key features of MCP Apple Notes
- Semantic search using on-device
all-MiniLM-L6-v2embeddings model - Full-text search capabilities
- Vector storage with LanceDB
- MCP-compatible server for AI assistant integration
- Native Apple Notes integration via JXA (JavaScript for Automation)
- Fully local execution – no API keys required
Use cases of MCP Apple Notes
- Searching your Apple Notes through natural language conversations with Claude
- Referencing specific notes or information without manual browsing
- Enabling RAG workflows where Claude answers questions using your local notes
- Integrating Apple Notes content into AI‑powered productivity tools
FAQ from MCP Apple Notes
What are the prerequisites for MCP Apple Notes?
You need Bun and Claude Desktop installed on your macOS machine. No other external services or API keys are required.
How do I install and configure MCP Apple Notes?
Clone the repository, run bun install, then edit your claude_desktop_config.json (located in Claude Desktop settings) to add the server with the command bun and the argument pointing to the index.ts file.
How do I start indexing my notes?
After restarting Claude Desktop, ask Claude to "Index my notes" or "Index my Apple Notes". The server will process your notes locally and store embeddings in LanceDB.
Where can I find logs if something goes wrong?
Logs are available at ~/Library/Logs/Claude/mcp-server-local-machine.log or ~/Library/Logs/Claude/mcp.log. You can tail them with tail -n 50 -f.
Does MCP Apple Notes require any API keys or internet access?
No. It is fully local – no API keys are needed and the semantic search runs on‑device using the all-MiniLM-L6-v2 model.
More Memory & Knowledge MCP servers
Basic Memory
basicmachines-coAI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN
Mcp Knowledge Graph
shanehollomanMCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development
Memory Bank MCP Server
alioshrA Model Context Protocol (MCP) server implementation for remote memory bank management, inspired by Cline Memory Bank.
mcp-local-rag
nkapila6"primitive" RAG-like web search model context protocol (MCP) server that runs locally. ✨ no APIs ✨
Ultimate Google Docs & Drive MCP Server
a-bonusThe Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.
Comments