Mcp Apple Notes

Name: Mcp Apple Notes
Author: RafalWilinski

by RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401 2 tools GitHub

No known CVEs

No license

Stale

Last commit 561d ago

Works with most clients

Transport: stdio, http

2 tools · ~127 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "local-machine": {
      "args": [
        "/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"
      ],
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mcp-apple-notes)](https://mcppedia.org/s/mcp-apple-notes)

Read me

What Mcp Apple Notes does

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

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

62/100across 5 weighted dimensions

How we score →

0255075100

−38

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (2)

Click any tool to inspect its schema.

~127 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mcp Apple Notes safe to use?: Mcp Apple Notes has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Mcp Apple Notes?: Mcp Apple Notes supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mcp Apple Notes do?: Mcp Apple Notes provides 2 tools: index_notes, search_notes. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mcp Apple Notes?: Mcp Apple Notes is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Mcp Apple Notes actively maintained?: Mcp Apple Notes is not actively maintained — last commit was 561 days ago. It has 401 GitHub stars.

Similar servers

Others in productivity

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

87.9k 1

Memory MCP Server98

Persistent memory using a knowledge graph

87.9k 5

Qmd95

mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local

27.3k 4

Superlocalmemory MCP Server94

Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.

187 6

MCP Security Weekly

Get CVE alerts and security updates for Mcp Apple Notes and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Features

🔍 Semantic search over Apple Notes using all-MiniLM-L6-v2 on-device embeddings model

📝 Full-text search capabilities

📊 Vector storage using LanceDB

🤖 MCP-compatible server for AI assistant integration

🍎 Native Apple Notes integration via JXA

🏃‍♂️ Fully local execution - no API keys needed

Usage

Open Claude desktop app and go to Settings -> Developer -> Edit Config

Open the claude_desktop_config.json and add the following entry:

{ "mcpServers": { "local-machine": { "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun", "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"] } } }

Important: Replace <YOUR_USER_NAME> with your actual username.

Restart Claude desktop app. You should see this:

Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".

Todos

Apple notes are returned in the HTML format. We should turn them to Markdown and embed that

Chunk source content using recursive text splitter or markdown text splitter

Add an option to use custom embeddings model

More control over DB - purge, custom queries, etc.

Storing notes in Notes via Claude

Frequently Asked Questions

Is Mcp Apple Notes safe to use?

Mcp Apple Notes has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Mcp Apple Notes?

Mcp Apple Notes supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Mcp Apple Notes do?

Mcp Apple Notes provides 2 tools: index_notes, search_notes. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Mcp Apple Notes?

Mcp Apple Notes is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Mcp Apple Notes actively maintained?

Mcp Apple Notes is not actively maintained — last commit was 561 days ago. It has 401 GitHub stars.

MCP Apple Notes

Features

🔍 Semantic search over Apple Notes using all-MiniLM-L6-v2 on-device embeddings model
📝 Full-text search capabilities
📊 Vector storage using LanceDB
🤖 MCP-compatible server for AI assistant integration
🍎 Native Apple Notes integration via JXA
🏃‍♂️ Fully local execution - no API keys needed

Prerequisites

Installation

Clone the repository:

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

Install dependencies:

bun install

Usage

Open Claude desktop app and go to Settings -> Developer -> Edit Config

Open the claude_desktop_config.json and add the following entry:

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

Important: Replace <YOUR_USER_NAME> with your actual username.

Restart Claude desktop app. You should see this:

Start by indexing your notes. Ask Claude to index your notes by saying something like: "Index my notes" or "Index my Apple Notes".

Troubleshooting

To see logs:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Todos

Apple notes are returned in the HTML format. We should turn them to Markdown and embed that
Chunk source content using recursive text splitter or markdown text splitter
Add an option to use custom embeddings model
More control over DB - purge, custom queries, etc.
Storing notes in Notes via Claude