MCP Apple Notes

Apple Notesに対してセマンティック検索とRAG（検索拡張生成）を可能にするModel Context Protocol (MCP)サーバーです。Claude Desktop、Cursor、Windsurf、Clineなど、MCP互換のあらゆるクライアントで動作します。

機能

• 🔍 all-MiniLM-L6-v2 デバイス内埋め込みモデルを使用したApple Notesのセマンティック検索

• 📝 全文検索機能

• 📂 フォルダサポート — フォルダ一覧表示、フォルダごとの閲覧、フォルダによる検索フィルタリング

• 📊 LanceDB を使用したベクトルストレージ

• 🤖 MCP互換のあらゆるクライアント（Claude、Cursor、Windsurf、Clineなど）で動作

• 🍎 JXAによるネイティブなApple Notes統合

• 🔒 安全に試用できるオプションの読み取り専用モード

• 🏃♂️ 完全ローカル実行 — APIキー不要

Related MCP server: MCP Apple Notes

セキュリティと透明性

このサーバーはユーザーのプライベートなApple Notesを扱うため、完全な透明性を考慮して設計されています。Mac上で100%ローカルに動作します。

• クラウドなし、テレメトリなし — APIキーは不要で、データがマシンから外部へ送信されることはありません。

• ネイティブApple JXA — Apple公式のJavaScript for Automationスクリプトブリッジを使用しています。

• デバイス内埋め込み — all-MiniLM-L6-v2 モデルは @huggingface/transformers を介してローカルで実行されます。

• 検証可能 — ノートにアクセスする前に、すべてのコード（特に index.ts）を確認することを強く推奨します。

• GitHubリリースにはSHA-256チェックサムが含まれており、ダウンロードしたアーティファクトを検証できます。

インストールとセットアップ

ワークフローに合ったインストール方法を選択してください。

方法1: ソースからインストール（推奨）

リポジトリをローカルにクローンすることで、ソースコードを検査し、マシン上で何が実行されているかを正確に把握できます。

前提条件: Node.js (v18+) または Bun

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && bun install

{
  "mcpServers": {
    "apple-notes": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

NPMを使用する場合:

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && npm install

次に、MCPクライアントの設定にサーバーを追加します。/path/to/mcp-apple-notes をリポジトリをクローンしたパスに置き換えてください：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

ヒント: リスクなしで試したいですか？読み取り専用モードを有効にすると、探索中にすべての書き込み操作をブロックできます。 "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }

方法2: npxによるクイックスタート

セットアップ不要の方法を好み、公開されているnpmパッケージを信頼する場合は、MCP設定に直接以下を追加できます：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

セットアップ後、クライアントを再起動し、AIアシスタントに "index my notes" と指示して開始してください。

クライアントごとの手順

1. Settings → Developer → Edit Config を開く

2. 選択したJSON設定を claude_desktop_config.json に貼り付ける

3. Claude Desktopを再起動する

ログ:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-apple-notes.log

# npm version:
claude mcp add apple-notes npx -- -y @dan8oren/mcp-apple-notes
# or from source:
claude mcp add apple-notes npx -- tsx /path/to/mcp-apple-notes/index.ts

JSON設定を ~/.cursor/mcp.json（グローバル）またはプロジェクトルートの .cursor/mcp.json に追加します。

JSON設定を ~/.windsurf/mcp.json に追加します。

利用可能なツール

信頼する前の検証

すべてのApple Notes操作は、index.ts で確認できる JXA 呼び出しです。ネットワークリクエストやバックグラウンド同期はなく、ローカルのスクリプトブリッジ呼び出しのみが行われます。

読み取り専用モード

安全策が必要ですか？読み取り専用モードを有効にすると、すべての書き込み操作がブロックされ、検索、一覧表示、読み取りツールのみが利用可能になります：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }
    }
  }
}

有効にすると、index-notes、list-folders、list-notes、search-notes、get-note のみが利用可能になります。

詳細モード

詳細ログを有効にすると、すべてのJXA呼び出しが実行前にstderrに記録されます：

CLIフラグ — MCPクライアント設定のargsに --verbose を追加します：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["--verbose", "-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

環境変数 — env をサポートするクライアントの場合：

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_VERBOSE": "1" }
    }
  }
}

JXA操作リファレンス

すべての操作はAppleのJXAスクリプトブリッジ (Application('Notes')) を介して行われます。直接的なファイルシステムアクセスやネットワーク呼び出しはありません。delete 操作は永続的ではなく、ノートは「最近削除した項目」に移動され、30日以内であれば復元可能です。

レスポンス形式

ツールのレスポンスは、一貫したエンベロープを持つJSONオブジェクトです：

• 成功: { "ok": true, "data": ... }

• エラー: { "ok": false, "error": { "type": "...", "message": "..." } }

ほとんどのノート関連のレスポンスには、名前変更や移動があってもクライアントが安全にノートを追跡できるように、安定したApple Notesの id が含まれるようになりました。

謝辞

元々は RafalWilinski/mcp-apple-notes に基づいています。