Apple Notes MCP Server

Apple Notes MCP Server とは？

Apple Notes MCP Server（RafalWilinski による mcp-apple-notes）は、Claude が Apple メモを検索・読み取り・作成できるようにするローカルの apple notes mcp server で、オンデバイスの埋め込みモデルによるセマンティック検索と RAG を備えています。

コミュニティによるオープンソースプロジェクトで、Apple の公式製品ではありません。JXA（JavaScript for Automation）でメモアプリからメモを読み込み、all-MiniLM-L6-v2 モデルで埋め込みを作成し、ベクトルを Mac 上の LanceDB に保存します。API キーもクラウドサービスも使わないため、メモについて自然な言葉で質問すると、Claude が関連するメモを見つけてくれます。なお、リポジトリは 2024 年 12 月以降更新されておらず、未解決の issue でセットアップの問題がいくつか報告されています（トラブルシューティングを参照）。

Apple Notes MCP Server の使い方

前提条件：Apple メモアプリが入った Mac、Bun、そして Claude Desktop などの MCP クライアント。

リポジトリをクローンして依存関係をインストールします。

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

Claude Desktop

1. Claude Desktop を開き、Settings → Developer → Edit Config に進みます。
2. claude_desktop_config.json に、Bun で index.ts を実行するエントリを追加します。

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

<YOUR_USER_NAME> を macOS のユーザー名に置き換え、パスがクローンした場所と一致していることを確認してください。README の例ではフォルダ名が apple-notes-mcp になっていますが、git clone で作られるのは mcp-apple-notes です。この不一致はリポジトリの未解決 issue でも指摘されています。

3. Claude Desktop を再起動し、サーバーが接続済みと表示されることを確認します。
4. 検索する前に、Claude に "Index my notes" または "Index my Apple Notes" と依頼します。メモの数によって、インデックス作成には数秒から数分かかります。

Claude Code

README に記載されているのは Claude Desktop だけです。Claude Code でも同じ stdio コマンドを実行できます。

claude mcp add apple-notes -- /Users/<YOUR_USER_NAME>/.bun/bin/bun /Users/<YOUR_USER_NAME>/mcp-apple-notes/index.ts

Cursor などのほかの MCP クライアントでも、mcpServers の設定で同じ command と args を使えます。macOS から、サーバーを起動するアプリにメモの操作を許可するよう求められる場合があります。

Apple Notes MCP Server の主な機能

• オンデバイスの all-MiniLM-L6-v2 埋め込みモデルによる Apple メモのセマンティック検索。
• ベクトル検索に加えた全文検索。
• LanceDB によるローカルのベクトルストレージ。
• JXA による Apple メモへのネイティブアクセス（エクスポート不要）。
• Claude からのメモ作成（create-note ツール）。
• API キー不要の完全なローカル実行。
• Bun でそのまま動く小さな TypeScript のコードベース。

Apple Notes MCP Server のツール

サーバーは index.ts で 5 つのツールを登録しています。

• インデックス作成： index-notes はすべてのメモを読み込み、セマンティック検索用のインデックスを作ります。最初に実行し、メモを大量に追加した後にも再実行してください。
• メモの検索： search-notes はインデックスを使ってタイトルや内容で検索し、list-notes はすべてのメモのタイトルだけを返します。
• 読み取り： get-note はタイトルを指定してメモの全文と詳細を返します。
• 書き込み： create-note はタイトルと内容から新しいメモを作成します。内容は改行を含まない HTML である必要があります。

Apple Notes MCP Server のユースケース

• 思い出す： "What did I write about the Q3 offsite?" に自分のメモから答えます。
• 古いメモを探す： "Find the note where I saved the router setup steps."
• テーマごとの要約： "Summarize everything in my notes about the kitchen renovation."
• RAG 用の個人ナレッジベース： 一般知識ではなく自分のメモに基づいて Claude に回答させます。
• チャットから記録する： "Save this meeting summary as a new note called 'Weekly sync'."

Apple Notes MCP Server と代替ツールの比較

• ほかの apple notes mcp server プロジェクト： AppleScript でメモアプリを操作し、フォルダ対応や編集・削除の操作を加えたコミュニティ製サーバーがいくつかあります。このリポジトリのフォークもあり、たとえば Dan8Oren/mcp-apple-notes（フォルダ対応とバグ修正）や、JXA を使わずメモのデータベースを直接読む connerkward/mcp-apple-notes があります。選ぶ前にメンテナンス状況を確認してください。
• Obsidian MCP Server： メモが Apple メモではなく Obsidian vault の Markdown ファイルにある場合に適しています。
• Notion MCP Server (Official)： Notion に保存したメモやドキュメント向けで、ベンダーがメンテナンスしています。

Apple Notes MCP Server のトラブルシューティング

• サーバーが起動しない： args のパスが index.ts の実際の場所（クローンしたフォルダは mcp-apple-notes）を指しているか、command が Bun の実行ファイル（~/.bun/bin/bun）を指しているかを確認します。
• ログを確認する： tail -n 50 -f ~/Library/Logs/Claude/mcp.log を実行するか、同じフォルダにあるサーバー固有の mcp-server-<name>.log を確認します。
• インデックス作成がタイムアウトする： メモが多いと index-notes が Claude Desktop のリクエストタイムアウトより長くかかるという issue が報告されています。繰り返し発生する場合、インデックス作成を大幅に高速化したと報告しているコミュニティのフォークがあります。
• JXA のエラー： 最近の macOS で依存ライブラリ run-jxa が動かないという報告があります。システム設定で、サーバーを起動するアプリにメモの自動操作が許可されているか確認し、解決しない場合はメンテナンスされているフォークを検討してください。
• 最近のメモが検索に出てこない： 再度 "index my notes" と依頼して、新しいメモの埋め込みを作成します。