mcp-apple-notes

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables semantic search and retrieval of Apple Notes content, allowing access to notes during AI assistant conversations. Supports both full-text and semantic search capabilities using on-device embeddings.

MCP Appleノート

Apple Notes上でセマンティック検索とRAG(Retrieval Augmented Generation)を可能にするモデルコンテキストプロトコル(MCP)サーバー。これにより、ClaudeのようなAIアシスタントが会話中にApple Notesを検索・参照できるようになります。

特徴

  • 🔍 all-MiniLM-L6-v2オンデバイス埋め込みモデルを使用した Apple Notes のセマンティック検索
  • 📝 全文検索機能
  • 📊 LanceDBを使用したベクトルストレージ
  • 🤖 AIアシスタント統合のためのMCP互換サーバー
  • 🍎 JXA によるネイティブ Apple Notes 統合
  • 🏃‍♂️ 完全にローカルで実行 - API キーは不要

前提条件

インストール

  1. リポジトリをクローンします。
git clone https://github.com/RafalWilinski/mcp-apple-notes cd mcp-apple-notes
  1. 依存関係をインストールします:
bun install

使用法

  1. Claudeデスクトップアプリを開き、「設定」->「開発者」->「設定の編集」に移動します。

  1. claude_desktop_config.jsonを開き、次のエントリを追加します。
{ "mcpServers": { "local-machine": { "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun", "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"] } } }

重要: <YOUR_USER_NAME>実際のユーザー名に置き換えてください。

  1. Claudeデスクトップアプリを再起動します。次のような画面が表示されます。

  1. まずはノートのインデックス作成から始めましょう。「ノートのインデックス作成」や「Apple Notesのインデックス作成」などと話しかけ、Claudeにノートのインデックス作成を依頼しましょう。

トラブルシューティング

ログを表示するには:

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

すべて

  • [ ] AppleのメモはHTML形式で返されます。これをMarkdown形式に変換して埋め込む必要があります。
  • [ ] 再帰テキストスプリッターまたはマークダウンテキストスプリッターを使用してソースコンテンツをチャンク化する
  • [ ] カスタム埋め込みモデルを使用するオプションを追加
  • [ ] DB のより詳細な制御 - パージ、カスタム クエリなど。
  • [x] Claude経由でNotesにメモを保存する
-
security - not tested
F
license - not found
-
quality - not tested

Apple Notes でセマンティック検索と RAG (検索拡張生成) を有効にします。

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Troubleshooting
            1. Todos
              ID: 19dbdavht0