Numbers Native

Numbers Native

ウェブサイト · ダウンロード · Italiano · MCP Registry · サポート

Viames Marino が開発した、Codex 向けの Apple Numbers ネイティブツールです。MIT License の下でオープンソースとして公開されています。

Numbers Native を使うと、Apple Numbers アプリケーションを通じて、Codex が実際の .numbers ドキュメントを作成、確認、編集できます。計算と独自のネイティブ形式での保存は Numbers が行います。Excel への変換、XLSX ライブラリ、リバースエンジニアリングされたファイル書き込みツール、リモート MCP サービス、追加の OpenAI API キーは不要です。

バージョン 0.5.0 はプレビュー版です。 ローカルでのネイティブ検証や移植性チェックを行っても、すべての Mac での互換性が保証されるわけではありません。検証と機能対応状況をご覧ください。

要件

• Apple Numbers がインストールされた Mac と、ログイン済みのグラフィカルセッション。
• Node.js 22 以降が Codex ホストの PATH で利用可能であること。
• ローカルの stdio MCP サーバーとプラグインマーケットプレイスに対応した Codex 環境。
• macOS に表示される実際のホストが、システム設定 → プライバシーとセキュリティ → オートメーションで Numbers を制御する許可を得ていること。

このバージョンでは Apple Events を使用するため、アクセシビリティの許可は必要ありません。Linux／Windows 環境や隔離されたクラウド実行環境では、ネイティブツールを実行できません。

Codex にインストールする

codex plugin marketplace add viames/numbers-native
codex plugin add numbers-native@viames-numbers

新しいローカル Codex タスクを開始し、セットアップスキルを実行してください。対応するデスクトップクライアントでは、プラグインマーケットプレイスを追加から https://github.com/viames/numbers-native を追加することもできます。

この合成例では、ネイティブのグラフが更新され、Materiali が 150 EUR、合計が 265 EUR、残額が 35 EUR になります。

リリースをダウンロードする

マーケットプレイスリリースを恒久的に使用するディレクトリに解凍してください。.agents/plugins/marketplace.json と plugins/numbers-native/ が含まれています。バンドルされたサーバーには JavaScript の依存関係が含まれているため、ユーザーが npm install を実行する必要はありません。

最近の Codex CLI で、解凍したディレクトリから次を実行します。

codex plugin marketplace add .
codex plugin add numbers-native@viames-numbers

新しい Codex セッションを開始し、@Numbers Native または Numbers／セットアップスキルを呼び出してください。リポジトリのマーケットプレイスに対応したデスクトップクライアントでは、この解凍したディレクトリをプロジェクトとして開き、プラグインから Viames Numbers マーケットプレイスを選択します。ホストのバージョンやワークスペースポリシーによって、マーケットプレイスが検出されるかどうかが変わる場合があります。CLI での登録は明示的に行われます。

デスクトップホストが node を見つけられない場合は、Node.js をインストールし、そのホストの PATH に追加してください。互換性のあるクライアントの MCP 設定に、MCP サーバーを直接登録することもできます。その場合は、解凍したサーバーの絶対パスを使用してください。

{
  "mcpServers": {
    "numbers-native": {
      "command": "node",
      "args": ["/absolute/path/to/numbers-native/plugins/numbers-native/dist/server.mjs"]
    }
  }
}

MCP の生の設定は、stdio MCP に対応したクライアント向けの代替手段であり、プラグインのスキルはインストールされません。この方法を使う場合は、Codex の直接 MCP 接続をネイティブ TOML 形式で設定してください。config.toml に JSON を貼り付けないでください。

セットアップを実行してから、次の例を試してください。

選択したフォルダーに、月次予算用の独立した表を 2 つ作成し、数式を含めた Numbers のネイティブドキュメントを作成してください。合計を読み上げて、.numbers ファイルを保存してください。

指定した Numbers ドキュメントを確認し、Expenses 表を見つけて、私が提示した値だけを更新してください。

対応範囲と制限

このプラグインは、書類、テンプレート、シート、テーブル、範囲の読み書き、ネイティブ数式、書式設定、消去／結合、並べ替え／転置、行／列、選択、検索、テキスト／図形／画像、既存オブジェクトのジオメトリに対応する、型付きの MCP ツールを38個提供します。オプションの PDF／CSV エクスポートは Numbers 自体が実行します。

バージョン0.5.0では、複数テーブルのセル編集を安全に制御する機能、読み取り専用のネイティブ結果チェック、型付き CSV／TSV の追加／アップサートが追加されました。データワークフローを参照してください。バージョン0.4.0では、ネイティブ／補助ファイルの完全なバックアップ、復元、移動／名前変更、ネイティブの PDF／PNG プレビュー（手順に沿った変更前／変更後の画像を含む）、ローカルの互換性診断が追加されました。ファイル／プレビューワークフローを参照してください。互換形式の保持、カスタムプロトタイプ、手順に沿ったソース更新も引き続き利用できます。11種類のネイティブテンプレートのグラフプロファイルを保持しています。新しいワークフローを参照してください。縦棒、横棒、円、ドーナツ、レーダー、インタラクティブ縦棒、積み上げ縦棒、面、二軸、散布図、バブルチャートに対応しています。グラフワークフローを参照してください。二軸、散布図、バブルチャートでは、軸のキャプション（天気、燃料消費量、売上）が固定されます。ドキュメントに記載されたデータの意味に従ってください。プロファイルは Numbers 14.5 で検証されており、未検証のリリースやテンプレート構造の変更がある場合は明示的に失敗します。

読み書きの呼び出しは2,000セル、行／列の挿入／削除の呼び出しは100項目に制限されます。大きなテーブルはページ単位で処理してください。通常の文字列は、先頭の = や先頭のゼロを含め、リテラルテキストとして扱われます。数式には { "formula": "=SUM(B2:B5)" } が必要です。日付には { "date": "2026-10-18T10:30:00Z" } が必要です。ブール値にはネイティブのチェックボックスセルを使用します。Numbers は、現在の書類の言語設定に応じて、数式と書式設定済みの値を返すことがあります。

グラフは、検証済みのテンプレートプロファイルを使って新規書類に作成できます。最大100個のデータポイントに対応し、プロファイルごとに1～10個の数値列という制限があります。ソースセルは通常の Numbers ツールで編集でき、Numbers が連動するグラフを更新します。グラフの種類、系列参照、色、内部タイトル、既存書類への任意の位置への挿入には対応していません。オプションの見出しは、独立したネイティブのテキスト項目です。ピボットの作成、条件付きルール、コメント、共同作業、パスワード、詳細な数値形式、ネイティブでの複製には、引き続き対応していません。

Numbers は自動保存します。書き込みはアトミックではなく、一部のみ適用されることがあります。同一サーバー内および連携するプラグインサーバー間の複数の呼び出しは直列化されますが、ユーザーや他のアプリが同時に編集する可能性はあります。エラー後は状態を確認し、タイムアウトした変更操作を自動で再試行しないでください。このプラグインは、無関係な書類を開いたままにします。

プライバシーとローカル実行

MCP ブリッジは、ネットワークリクエストの送信、ネットワークポートでの待ち受け、テレメトリの収集、書類の別サービスへのアップロードを行いません。入力と結果は Codex を経由し、ホストのポリシーに応じて Codex のモデルに送信される場合があります。ローカルで自動化していても、すべてのスプレッドシートデータがデバイス内にとどまるとは限りません。

デフォルトでは、ツールは明示的に選択されたローカルパスと、識別済みの開いている書類にアクセスできます。アクセスを制限するには、MCP サーバーの環境で NUMBERS_NATIVE_ALLOWED_ROOTS を、既存の絶対ディレクトリを含む JSON 配列に設定します。

{ "NUMBERS_NATIVE_ALLOWED_ROOTS": "[\"/Users/your-user/Documents/Numbers\"]" }

シンボリックリンクによる範囲外へのアクセスを拒否するため、パスは正規化されます。これはブリッジによる追加チェックであり、Numbers 自体に対する OS のサンドボックスではありません。Numbers は自身のファイル依存関係を解決できます。プライバシーの詳細。

開発と検証

npm ci
npm test
npm run build
npm run test:native
npm run test:charts
npm run test:guided
npm run test:files
npm run test:workflows
npm run package

test:native は Numbers を起動し、独自の一時ドキュメントを作成して、ネイティブ環境での結果をテストします。ユーザードキュメントをテスト用データとして使用することはありません。GUI／Automation の権限が必要で、ポータブル CI とは別に実行されます。単体テストと MCP テストはほかのオペレーティングシステムでも実行されますが、ネイティブ操作は実行されません。

リリースプロセスでは、ランタイム、スキル、ネイティブワーカー、通知、ライセンスをバンドルしたマーケットプレイス用 ZIP とスタンドアロンプラグイン用 ZIP を作成し、SHA-256 チェックサムも生成します。メンテナーは、固定されたロックファイルから再ビルドします。バンドルされていないソースも確認用にスタンドアロンプラグインに含まれます。マーケットプレイス用 ZIP には、ソースリポジトリ全体が含まれます。

一般公開

公開ソースマーケットプレイスは viames/numbers-native です。バージョン付きリリースには、Codex マーケットプレイス用 ZIP、スタンドアロンプラグイン用 ZIP、macOS 用 .mcpb バンドル、レジストリメタデータ、SHA-256 チェックサムが含まれます。MCPB クライアントは同じネイティブツールを利用でき、Codex プラグインにはスキルも含まれます。公式 MCP Registry の ID は io.github.viames/numbers-native です。レジストリへの登録が成功したと想定せず、最新のレコードを確認してください。リポジトリ／レジストリでの配布は、公式 OpenAI ディレクトリへの掲載とは別です。

2026 年 10 月 18 日時点で確認したところ、OpenAI のデスクトップ専用の申請ルールでは、ローカル MCP の申請は承認済みパートナーに限定され、申請する組織は許可リストに登録されている必要があります。パッケージが機能することは、ディレクトリへの申請資格や承認の証明にはなりません。公開手順を参照してください。

Numbers Native は独立したプロジェクトであり、Apple または OpenAI とは提携しておらず、両社からの承認も受けていません。Apple Numbers が必要ですが、同梱されていません。