Skip to content
MCP server

Numbers Native

Create and edit native Apple Numbers documents on a Mac, with real formulas and charts

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
0.5.1-catalog.1
Listing updated
2 days ago

About Numbers Native

Numbers Native is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

MIT licensed, free

Prices change. Check viames.github.io before you buy.

Numbers Native 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 to Numbers Native

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents