MCP.so
Sign In

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

Category

Memory & Knowledge

Runtime

node

Transports

stdio

Publisher

RafalWilinski

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-v2 embeddings 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.

Comments

More Memory & Knowledge MCP servers