# Numbers Native

> Numbers Native is an open-source MCP server for files and documents. Create and edit native Apple Numbers documents on a Mac, with real formulas and charts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Website:** https://viames.github.io/numbers-native/
- **Repository:** https://github.com/viames/numbers-native
- **MCP Registry name:** io.github.viames/numbers-native
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-15

## About

Rather than converting to Excel and back, this server drives the Numbers app itself through Apple Events, so Numbers does the calculating and saves its own format. Its 38 tools cover tables, formulas, formatting, custom prototypes and eleven verified chart profiles with guided source updates.

Edits can be previewed before they are applied, typed CSV or TSV records can be imported by key, and before-and-after PDF and PNG previews are available. Backup, restore and move operations carry chart metadata along with the document. Imports are limited to a 2,000-cell resulting table.

It is a 0.5.0 public preview by Viames Marino under the MIT licence, verified on one Mac with Numbers 14.5. It needs Node.js 22 or later and macOS Automation permission, runs only on a logged-in Mac, and cannot run in Linux, Windows or isolated cloud executors. The site says operations can partially apply with no automatic rollback and that there is no telemetry or direct network upload.

## Features

- **Native Numbers editing:** Works through the Numbers app, with no Excel or XLSX conversion.
- **Guided charts:** Eleven verified chart profiles with source updates.
- **Previewable edits:** Check related changes and render before-and-after PDF or PNG previews.
- **Keyed CSV and TSV import:** Update records by key, within a 2,000-cell result.
- **Document backup and restore:** Move native documents together with chart metadata.

## Good for

- Build a monthly budget with formulas in a Numbers file
- Update a chart's data without rebuilding it
- Import a CSV of records into an existing table by key
- Produce before-and-after previews of a spreadsheet change

## Install

### Claude Code (Terminal)

```sh
claude mcp add numbers-native -- npx -y https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "numbers-native": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "numbers-native": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "numbers-native": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "numbers-native": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "numbers-native": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb"
      ]
    }
  }
}
```

## FAQ

### Which platforms does it run on?

macOS only, with Apple Numbers installed and Automation permission granted.

### What Node.js version is needed?

Node.js 22 or later.

### Is it open source?

Yes, under the MIT licence.

### Can edits be undone automatically?

No. The site says operations can partially apply and have no automatic rollback; use backups.

### Is it production-ready?

It is a public preview, verified on one Mac with Numbers 14.5.

### Is Numbers Native free?

Yes. Numbers Native is open source, so you can use and self-host it for free.

### How do I add Numbers Native to Claude Code?

Run this command in your terminal: claude mcp add numbers-native -- npx -y https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb

### What are the best alternatives to Numbers Native?

The closest alternatives to Numbers Native are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/numbers-native
