mcpField
A
Apple Reminders

Apple Reminders

ローカル
cupertino.mgcrea.io生産性5今日更新
リポジトリ公式サイト

Apple Reminders について

macOS の Apple Reminders 用 MCP サーバーです。Apple Events を使い、追加の読み取りには任意の読み取り専用 SQLite インデックスも利用できます。書き込みツールは既定で登録されず、設定で有効にできます。

主な機能

  1. 01アカウント、リスト、リマインダーの一覧表示
  2. 02リマインダーの検索と取得
  3. 03タグと添付ファイルにはフルディスクアクセスが必要
  4. 04書き込みツールは既定で無効

活用シーン

  1. 01特定のリマインダーを検索
  2. 02リマインダーと所属リストを確認
  3. 03書き込みツールを有効にして作成や完了処理

MCP 対応

MCP クライアントに Apple Reminders の読み取りと検索ツールを提供します。作成、更新、完了、移動、削除ツールは APPLE_REMINDERS_ALLOW_WRITES=1 の場合にのみ登録され、書き込みは常に Apple Events 経由で行われます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mgcrea-mcp-apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-reminders"
      ],
      "env": {
        "APPLE_REMINDERS_ALLOW_WRITES": "<APPLE_REMINDERS_ALLOW_WRITES>",
        "APPLE_REMINDERS_LISTS": "<APPLE_REMINDERS_LISTS>",
        "APPLE_REMINDERS_ACCOUNTS": "<APPLE_REMINDERS_ACCOUNTS>"
      }
    }
  }
}
起動コマンドnpx -y @mgcrea/mcp-apple-reminders
設定が必要な環境変数
APPLE_REMINDERS_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
APPLE_REMINDERS_LISTSRestrict every read and write to these Reminders lists, by name.
APPLE_REMINDERS_ACCOUNTSRestrict every read and write to these Reminders accounts, by name or id. Bounds reading, not just writing.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@mgcrea/mcp-apple-reminders1.31.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

@mgcrea/mcp-apple-reminders

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

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

2 つのレーン

  • Apple Events レーン — アカウント、リスト、リマインダー、およびすべての変更を扱います。Reminders のスクリプティング辞書は十分に整備されているため、このレーンだけで実用的なサーバーとして動作します。
  • インデックスレーン — Group Containers のストアを読み取り専用の SQLite で参照し、辞書では公開されていない情報を扱います。フルディスクアクセスが必要です。

Notes とは異なり、Mail と同様に、Apple Events レーンだけでも利用できます。インストールして使い始め、フルディスクアクセスを許可するかどうかはその後で判断できます。apple_reminders_diagnostics で、どちらのレーンが応答しているかを確認できます。

権限必要な用途許可しない場合
オートメーション → Remindersすべて何も動作せず、-1743 エラーが発生します
フルディスクアクセスタグ、添付ファイルサーバーは引き続き Apple Events レーンで動作します

Reminders.app 自体に権限を付与する必要はありません。権限が必要なのは、読み取りを行う側です。サーバーを起動するアプリ（Terminal、iTerm、VS Code、Claude）に権限を付与し、その後再起動してください。

ツール

読み取り：diagnostics、list_accounts、list_lists、list_reminders、search_reminders、get_reminder。

書き込みツールは、APPLE_REMINDERS_ALLOW_WRITES=1 の場合にのみ登録されます。このフラグがオフの場合、単に拒否されるのではなく、モデルから見えなくなります：create_reminder、update_reminder、complete_reminders、move_reminders、delete_reminders。

設定

変数デフォルト
APPLE_REMINDERS_ALLOW_WRITESオフ変更を行うツールを登録します。
APPLE_REMINDERS_ACCOUNTSすべて読み取り側の許可リスト。カンマ区切りです。
APPLE_REMINDERS_LISTSすべて読み取り側の許可リスト。カンマ区切りです。
APPLE_REMINDERS_DEFAULT_LISTReminders'リストを指定せずに新しいリマインダーを作成する場合の保存先です。
APPLE_REMINDERS_INCLUDE_COMPLETEDオフ読み取り結果に完了済みリマインダーを含めます。
APPLE_REMINDERS_INDEX_MODEautoauto | ro | immutable | off。
APPLE_REMINDERS_STORE自動ストアのパスを明示的に指定します。
APPLE_REMINDERS_DEGRADED_MAX_REMINDERS500インデックスなしで動作する場合の上限です。
APPLE_REMINDERS_SEARCH_CACHE_TTL_MS30000コーパスをウォーム状態に保つ時間です。
APPLE_REMINDERS_ATTACHMENT_DIR~/Downloads添付ファイルの保存先として許可される唯一のディレクトリです。
APPLE_REMINDERS_OSASCRIPT_TIMEOUT_MS30000初回の権限確認ダイアログに対応できるよう設定されています。

注意が必要な点

  • ~/Library/Reminders は存在しません。 Reminders は ~/Library/Group Containers/group.com.apple.reminders/ にあります。他の場所でよく見かけるパスは、現在の macOS では誤りです。
  • 書き込みは常に Apple Events を通じて行われ、ストアには書き込みません。 Reminders アプリは SQLite ファイルを開いたまま保持し、サーバーと照合して同期するため、ファイルに直接書き込むと同期状態が破損します。
  • デフォルトでは完了済みリマインダーは除外されます。 検索でリマインダーが「見つからない」場合は、通常、完了済みになっているだけです。APPLE_REMINDERS_INCLUDE_COMPLETED=1 を設定してください。

ライセンス

MIT。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。