Apple Notes

@mgcrea/mcp-apple-notes

macOS の Apple Notes アプリ向け Model Context Protocol サーバーです。

非公式です。 Apple とは提携していません。Mac にすでにインストールされている Notes アプリを操作します。

2 つの経路

• Apple Events 経路 — アカウント、フォルダー、本文、およびすべての変更を扱います。常にこちらが正となります。 書き込み後、結果は Notes から再読み込みした内容になります。
• インデックス経路 — NoteStore.sqlite に対する読み取り専用の SQLite で、Apple Events では扱いきれない規模の検索とメタデータ取得に使います。フルディスクアクセスが必要です。

Mail とは異なり、Apple Events 経路だけでサーバーとして機能します。921 件のノートがあるライブラリで計測したところ、全文検索にかかる時間は 97 ms でした。Mail がインデックスを必要とする原因となった 74 秒と比べてください。そのため、まずインストールして使い始め、フルディスクアクセスを許可するかどうかはその後に決められます。

ただし、いつまでも拡張できるわけではありません。背後にインデックスがないため、クエリのたびに全コストがかかります。限界は約 5～10k 件のノートです。apple_notes_diagnostics で、どちらの経路が応答しているかを確認できます。

権限	必要となる機能	権限がない場合
Automation → Notes	すべて	何も動作せず、-1743 エラーが発生します
フルディスクアクセス	大規模な検索、save_attachment	サーバーは引き続き動作しますが、Apple Events 経路を使います

どちらの権限も Notes.app に付与するものではありません。権限が必要なのは、読み取りを行う側 です。

ツール

読み取り：diagnostics、list_accounts、list_folders、list_notes、search_notes、get_note、 list_attachments、save_attachment。

書き込み：APPLE_NOTES_ALLOW_WRITES=1 の場合にのみ登録されます。フラグがオフの場合、モデルから見えなくなるだけで、単に拒否されるわけではありません：create_note、update_note、move_note、delete_notes、 add_attachment。

add_attachment は、ノートに画像を追加する唯一の方法です。ノート本文に <img> タグを入れても、Notes が読み込まない添付ファイルが作成されるだけです。docs/notes.md を参照してください。

設定

変数	デフォルト
APPLE_NOTES_ALLOW_WRITES	off	変更を行うツールを登録します。
APPLE_NOTES_ACCOUNTS	all	読み取り側の許可リスト。カンマ区切りです。
APPLE_NOTES_INDEX_MODE	auto	auto | ro | immutable | off。
APPLE_NOTES_STORE	auto	NoteStore.sqlite のパスを明示的に指定します。
APPLE_NOTES_SEARCH_CACHE_TTL_MS	60000	本文コーパスをキャッシュに保持する時間です。
APPLE_NOTES_ATTACHMENT_DIR	~/Downloads	添付ファイルの保存先として許可される唯一のディレクトリです。
APPLE_NOTES_BODY_MAX_BYTES	262144	コンテキストウィンドウを保護するための本文の切り詰めサイズです。
APPLE_NOTES_OSASCRIPT_TIMEOUT_MS	30000	初回の権限確認プロンプトに合わせたタイムアウトです。

注意が必要な点

• Notes は本文の最初の行からノートのタイトルを取得します。 name を設定しても黙って無視されるため、create_note は代わりにタイトルを見出しとして先頭に追加します。
• パスワードで保護されたノートは一切読み取れません。 保存時のテキストは AES 暗号文であり、そのため ZICNOTEDATA に暗号関連の列が含まれています。どの権限を付与しても読み取り可能にはなりません。
• フォルダーは入れ子になります。 自分のライブラリがたまたまフラットであっても、フォルダーマップは再帰的に処理する必要があります。
• 検索キャッシュは無効化ではなく TTL で管理されます。 キャッシュが古くなっているかを Apple Events 経由で確認するには 128 ms かかり、スキャンを再実行する時間（97 ms）よりも長くなります。そのため、一定範囲の古さを許容するのが現実的な選択です。docs/notes.md を参照してください。

ライセンス

MIT。