Apple Notes Mcp Server

Apple Notes MCP サーバー

English | 简体中文

Claude が Apple Notes を読み書きできるようになります。ネイティブの書式設定、表、添付ファイル、iCloud 同期にも対応しています。

Claude は、あなた自身が編集するのと同じようにメモを編集します。1 行を書き換えたり、チェックボックスにチェックを入れたりしても、色やフォントなど、メモのほかの部分はそのまま維持されます。タイトル、見出し、リスト、チェックリスト、表、ハイライトは、すべて Apple Notes の本来のスタイルです。メモにある画像、スキャン、PDFを Claude が確認することも、フォルダを整理することもできます。

必要なもの： macOS 26（Tahoe）以降、Node.js 24 以降、および Claude Code、Claude Desktop（Cowork と Code のセッションを含む）、または claude.ai。ほかの MCP クライアントも利用できます。MCP 2026-07-28 と、旧式の initialize ハンドシェイク（2024-11-05 ～ 2025-11-25）に対応しています。

セットアップ

1. Claude に追加する

Claude Code — ターミナルで実行します。

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に追加し、Claude を再起動します。

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

claude.ai（ウェブおよびモバイル）— リモートアクセスを参照してください。

@latest を指定すると、自動で更新されます。Claude がサーバーを起動するたびに、npx が新しいバージョンを確認して取得します。

2. アクセス権を付与する

初めて必要になったときにセットアップウィンドウが開きます（または npx -y @ailenshen/apple-notes-mcp@latest setup を実行します）。Apple Notes MCP の次の 2 つをオンにしてください。

権限	理由
フルディスクアクセス	メモを読み取るため
オートメーション → Notes	変更を iCloud と同期し、メモを移動・削除するため

設定は一度だけで済みます。アクセス権はアップデート後も維持されます。

3. 使い始める

Claude に話しかけるだけです。

• 「今週、メモで何を変更しましたか？」
• 「買い物リストの牛乳にチェックを入れて、卵を追加して」
• 「会議のメモに『次のステップ』のセクションを追加して」
• 「レシートのメモにある写真には何が写っていますか？」
• 「海南旅行のメモを Travel に移動して」
• 「Work の各メモに 1 行の説明を書いて」
• 「Old Projects フォルダを ~/Documents/Archive/old-projects.zip にアーカイブしてから、削除して」

できること

ツール	説明
overview	フォルダ、またはサイズと 1 行の説明付きのメモを表示します。日付で絞り込み、日付またはタイトルで並べ替えられます
search	一致したテキストを含む全文検索を行います
read_note	メモを Markdown として読み取ります。ID またはタイトルで指定でき、複数のメモや 1 つのセクションだけを指定することもできます
read_attachment	メモ内の画像、スキャン、PDF、動画、表、ファイルを確認します
create_note	Markdown から新しいメモを作成します
edit_note	テキストの変更、見出しの下への追加、またはメモの書き換えを行います。複数の変更を一度に適用できます
describe_note	1 行の説明を、複数のメモにまとめて保存します
move_note	メモを別のフォルダに移動するか、「最近削除した項目」から復元します
manage_folder	フォルダの作成、名前変更、削除を行います。フォルダをディスクにエクスポート（Markdown と元の添付ファイル。任意で .zip 形式）するか、内容ごと削除することもできます
delete_note	メモを「最近削除した項目」に移動します

Claude があなた自身の編集を上書きすることはありません。Claude が読み取った後にメモが変更されていた場合、書き込みは拒否されます。変更前には、すべてのメモがバックアップされます。

Notes の Markdown

Notes	Markdown
タイトル／見出し／小見出し	# / ## / ###
箇条書き、ダッシュ付き、番号付きリスト	* / - / 1.
チェックリスト	- [ ] / - [x]
引用、等幅	>, ```
太字、斜体、取り消し線	**…**, *…*, ~~…~~
下線、ハイライト	<u>…</u>, <mark>…</mark>
リンク、表	[text](url), | a | b |

リモートアクセス

サーバーは stdio 経由で通信します。claude.ai から使うには、HTTP リクエストを stdio に転送するブリッジの背後に配置し、その URL をカスタムコネクターとして追加します。

1.x からのアップグレード

バージョン 2 は Swift で書き直されており、@latest を使うと自動的にインストールされます。変更点は次のとおりです。

• macOS 26（Tahoe）が必要です。古い Mac では、バージョン 1 を使用してください：npx -y @ailenshen/apple-notes-mcp@1。
• アクセス許可は Apple Notes MCP アプリに付与されます。セットアップウィンドウが一度開くので、2 つのスイッチをオンにしてください。
• Claude を再起動するか、コネクターに一度再接続してください。
• --http モードは廃止されました。リモートアクセスをご覧ください。引き続き使う場合は、@1 を使用してください。

動作の仕組み

• 読み取りには Notes 独自のデータフレームワークを使用し、読み取り専用で実行します。
• 書き込みでは、Notes 独自の編集オブジェクトを使って変更点のみを書き換えるため、Markdown では表示できない書式設定も含め、メモの他の部分には影響しません。
• 同期：変更のたびに、Notes に iCloud へのアップロードを指示します。
• Notes が前面に表示されることはなく、ダイアログも表示されません。

既知の制限事項

• 添付ファイルは読み取れますが、追加や削除はできません。
• フォルダはまだ移動できません。
• ロックされたメモは読み取れません。エクスポート時には、エクスポートされなかったものとして記載されます。共有メモは編集できますが、削除できません。
• Notes で編集した直後の表は、Claude が変更すると再構築され、セル内の書式設定がリセットされます。

ビジョン

Apple Notes は、Apple デバイス上で個人の知識を保管するのに最も自然な場所です。どこでも同期でき、高速で、プライバシーが守られます。しかし、API のない閉鎖的な環境です。

このプロジェクトは、Apple Notes を AI の第一級データソースにします。長期的な目標は、Mac、スマートフォン、ウェブのどこで AI と会話していても、Apple Notes にいつでもアクセスでき、読み取りや書き込みができるようにすることです。

ライセンス

MIT