Numbers Native
Create and edit native Apple Numbers documents on a Mac, with real formulas and charts
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents