Apple Notes

Apple Notes MCP

macOS 向けの Apple Notes MCP サーバーです。

メモやフォルダーにアクセスして、作成、整理、管理できます。Notes を記録の基準として維持しながら、エージェントによるメモの読み取り、作成、更新、移動、削除を可能にします。

使用する場面

• メモのみを扱うワークフロー
• オールインワンのサーバーより強力な分離が必要な場合
• ネイティブの Notes アプリを通じた、構造化されたメモとフォルダーの操作

機能

• アカウントとフォルダーを一覧表示
• メモの一覧表示、検索、管理（CRUD）
• フォルダーの作成、名前変更、削除
• メモの添付ファイルを一覧表示
• コンテキストに制約のあるクライアント向けのツール検出ヘルパー search_tools と get_tool_info
• 最近のメモのリソースと整理用プロンプト
• ヘルスチェックと権限確認：notes_health、notes_permission_guide、notes_recheck_permissions

この Mac へのインストール

uvx apple-mcp-notes

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

AI エージェントへのインストール

{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["apple-mcp-notes"],
      "env": {
        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

claude mcp add --transport stdio --scope user apple-notes -- uvx apple-mcp-notes

安全モード

• safe_readonly
• safe_manage
• full_access

トランスポート

デフォルトかつ推奨のトランスポートは stdio です。代わりに Streamable HTTP で提供するには、APPLE_NOTES_MCP_TRANSPORT=streamable-http を設定します（APPLE_NOTES_MCP_HOST と APPLE_NOTES_MCP_PORT は任意です）。

メモの読み取りと検索

一覧表示と検索の結果には、取得可能なメモのプレーンテキストが含まれるため、検索ではタイトルやタグだけでなく、本文テキストも照合できます。メモのプロパティは Notes.app の AppleScript コンテキストで読み取られます。メモのペイロードにフォルダーメタデータがない場合、一覧表示のリクエストごとに最大 1 回だけ取得されます。

Notes から返されるリテラルの制御文字や複雑な絵文字は、テキストを変更せずに Python 側でデコードされます。ロックされているメモや利用できないメモのフィールドは空のままの場合があります。引き続き Automation アクセスが必要です。

スクリプトのタイムアウト

すべての AppleScript 呼び出しには APPLE_NOTES_MCP_SCRIPT_TIMEOUT_SECONDS（デフォルトは 60、最小値は 5）による上限が設定されているため、Notes.app が応答停止しても MCP リクエストが無期限にハングすることはありません。作成がタイムアウトすると、NOTE_CREATE_STATUS_UNKNOWN が返されます。一致するタイトルと作成時刻だけでは、どの操作でメモが作成されたかを特定できないため、サーバーは一致するメモに変更を加えません。再試行する前に対象フォルダーを確認してください。メモのタイムスタンプには、UTC の Unix エポック値が使用されます。

macOS の権限

• Notes への Automation アクセスが必要です

起動チェックリスト

• MCP クライアントに uvx apple-mcp-notes（またはクローンの AppleNotes-MCP/start.sh）を追加します
• クライアントを再読み込みまたは再接続し、Notes のツール一覧をコンテキストに読み込みます
• 最初に notes_health を呼び出します
• Notes の Automation がブロックされている場合は、notes_permission_guide を呼び出します
• macOS の権限を変更した後は、notes_recheck_permissions を呼び出します

メモの使い方

• tools/list は Notes のツール一覧全体を返します。コンテキストに制約のあるクライアントは、まず search_tools を使い、次に必要な Notes ツールについて get_tool_info を使用できます。
• 複数のアカウントにそれぞれ Notes フォルダーが含まれている場合があります。初回使用時に利用可能なアカウントとフォルダーを確認し、デフォルトを設定してください。
• 参考資料や保存したコンテキストには Notes を使用してください。
• 時間に関係する項目には、代わりに Reminders または Calendar を使用してください。

関連項目

• Apple-Tools-MCP