Apple Notes에 대한 의미 검색과 RAG(검색 증강 생성)를 가능하게 하는 Model Context Protocol(MCP) 서버입니다. 이를 통해 Claude와 같은 AI 비서가 대화 중에 Apple Notes를 검색하고 참조할 수 있습니다.

특징

• 🔍 all-MiniLM-L6-v2 온디바이스 임베딩 모델을 이용한 Apple Notes의 의미 탐색
• 📝 전체 텍스트 검색 기능
• 📊 LanceDB를 이용한 벡터 저장
• 🤖 AI 어시스턴트 통합을 위한 MCP 호환 서버
• 🍎 JXA를 통한 네이티브 Apple Notes 통합
• 🏃 ♂️ 완전 로컬 실행 - API 키가 필요 없음

선수 조건

• 번
• 클로드 데스크톱

설치

1. 저장소 복제:

2. 의존성 설치:

사용

1. Claude 데스크톱 앱을 열고 설정 -개발자 > -> 설정 편집으로 가세요

2. claude_desktop_config.json를 열고 다음 항목을 추가합니다:

중요: 를 실제 사용자 이름으로 바꿔주세요.

3. Claude 데스크톱 앱을 재시작하세요. 이런 내용을 보실 겁니다:

4. 먼저 노트를 색인화하세요. 클로드에게 "내 노트를 색인화"나 "애플 노트 색인화"라고 말해 노트를 색인해 달라고 요청하세요.

문제 해결

로그를 보려면:

토도들

• [ ] 애플 노트는 HTML 형식으로 반환됩니다.

MCP Apple Notes

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.

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

• Bun
• Claude Desktop

Installation

1. Clone the repository:

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

2. Install dependencies:

bun install

Usage

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

2. Open the claude_desktop_config.json and add the following entry:

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

Important: Replace `` with your actual username.

3. Restart Claude desktop app. You should see this:

4. 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.
• [x] Storing notes in Notes via Claude