Numbers Native MCP server

Numbers Native

Website · Download · Italiano · MCP Registry · Support

Native Apple Numbers tools for Codex, by Viames Marino. Open source under the MIT License.

Numbers Native lets Codex create, inspect and edit real .numbers documents through the Apple Numbers application. Numbers performs the calculations and saves its own native format. No Excel conversion, XLSX library, reverse-engineered file writer, remote MCP service or additional OpenAI API key is involved.

Version 0.5.0 is a preview. Local native verification and portability checks do not establish compatibility on every Mac. See verification and feature coverage.

Requirements

• A Mac with Apple Numbers installed, in a logged-in graphical session.
• Node.js 22 or later, available on the Codex host's PATH.
• A Codex environment supporting local stdio MCP servers and plugin marketplaces.
• Permission for the actual host shown by macOS to control Numbers under System Settings → Privacy & Security → Automation.

This version uses Apple Events and does not require Accessibility permission. It cannot run its native tools in a Linux/Windows or isolated cloud executor.

Install in Codex

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

Start a new local Codex task and run the setup skill. You can also add https://github.com/viames/numbers-native through Add plugin marketplace in compatible desktop clients.

The synthetic example shows a native chart updating to Materiali 150 EUR, total 265 EUR and residual 35 EUR.

Download a release

Unzip the marketplace release into a permanent directory. It contains .agents/plugins/marketplace.json and plugins/numbers-native/. The bundled server includes its JavaScript dependencies, so users do not need to run npm install.

With a recent Codex CLI, from the extracted directory:

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

Start a new Codex session and invoke @Numbers Native or its Numbers/setup skill. In desktop clients supporting repository marketplaces, open this extracted directory as a project and select the Viames Numbers marketplace in Plugins. Host versions and workspace policies can affect marketplace discovery; the CLI registration is explicit.

If your desktop host cannot find node, install Node.js and ensure it is on that host's PATH. You can alternatively register the MCP server directly in a compatible client's MCP configuration, using the absolute path of the extracted server:

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

The raw MCP configuration is a fallback for clients that support stdio MCP; it does not install the plugin's skills. Configure Codex's direct MCP connection with its native TOML format if using that route. Do not paste JSON into config.toml.

Run setup, then try:

Shortened. The full README is on GitHub.