# Numbers Native (mcpb · numbers-native-0.5.0.mcpb)

Native Apple Numbers on macOS: formulas, guided charts, guarded edits and CSV. No Excel conversion.

- Trust score: 37/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-19

## Components

- mcpb · `numbers-native-0.5.0.mcpb`: 37/100 (this document), [markdown](https://verifymcp.io/servers/viames-numbers-native/numbers-native.md), [page](https://verifymcp.io/servers/viames-numbers-native/numbers-native)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb`
- Transport: `stdio`
- SHA-256: `aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-19.

- **Supply Chain Security**: 0/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: we found no dependency list to check in this bundle: either it runs a compiled binary, whose bundled manifests we do not read, or none of the package.json, requirements.txt, pyproject.toml or uv.lock files it ships for its runtime declares a dependency we can read (a requirements.txt that only points at a setup.py project, a local path, or a nested requirements file we cannot follow counts as none).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 4119 tokens (~108/item across 38 items; 38 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability observed for 0 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 78/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 33% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 2 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Numbers Native MCP server?

Numbers Native ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8; the commands to do that are on this page. If it does not match, do not open it.

- Download bundle: `https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb`
- SHA-256: `aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8`

### Verify on macOS / Linux

```bash
echo "aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8  numbers-native-0.5.0.mcpb" | shasum -a 256 -c
```

### Verify on Windows (PowerShell)

```powershell
(Get-FileHash -Algorithm SHA256 .\numbers-native-0.5.0.mcpb).Hash -eq "aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8"
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-19 (score 37)

First indexed and scored.

## MCP tools (38)

### `numbers_status` (~39 tokens)

Check macOS, Numbers, native capabilities and limits. launch=true starts Numbers and tests Automation permission. No document edits.

Input parameters:

- `launch` (boolean)

### `numbers_diagnostics` (~66 tokens)

Report local Node/macOS/Numbers/locale/PDFKit capabilities and verified chart-version/template availability. launch=true tests Automation and reads installed template IDs; it creates no test documents. Unknown availability remains unknown. Does not claim another Mac/version was tested.

Input parameters:

- `launch` (boolean)

### `numbers_edit` (~140 tokens)

Preview or apply guarded cell edits across existing tables in ONE document. Max 20 nonoverlapping edits/2,000 written cells, 5,000 inspected cells. Apply the identical request with expected_revision. Reports formula overwrites and post-checks using native Numbers results. No formula translation, rollback or transaction; failed post-checks do not undo edits.

Input parameters:

- `checks` (array)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `edits` (array, required)
- `expected_revision` (string)
- `preview` (boolean)
- `save` (boolean)

### `numbers_check` (~102 tokens)

Read-only native value/formula checks: required, unique, formula presence, numeric bounds, equality and balances. Explicit ranges/checks only, at most 5,000 inspected cells, 2,000 per range. Missing formula results are suspected errors; no complete dependency analysis.

Input parameters:

- `checks` (array)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `ranges` (array)

### `numbers_import` (~233 tokens)

Preview/apply UTF-8 CSV/TSV into an existing native table using explicit header/type mappings. append or exact typed-key upsert, no deletion. Source bytes and target snapshot must match expected_revision. One header, no footer/filter, target <=2,000 cells including growth, <=2,000 written cells. Strings remain literal; formulas protected by default. No automatic formula fill or certified chart-reference growth.

Input parameters:

- `checks` (array)
- `delimiter` (string)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `expected_revision` (string)
- `key_column` (string)
- `mapping` (array, required)
- `mode` (string, required)
- `overwrite_formulas` (boolean)
- `preview` (boolean)
- `save` (boolean)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `source_path` (string, required)
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_preview` (~113 tokens)

Export the current document to a NEW PDF path and render one page to a NEW sibling PNG using macOS PDFKit. Returns native image content for inspection without Poppler or UI automation. Page is PDF-page index, not sheet index. Does not certify chart references. Existing files are not overwritten.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `max_dimension` (integer)
- `page` (integer)
- `path` (string, required)

### `numbers_restore` (~65 tokens)

Restore a native .numbers backup AND its chart companion to a NEW path, opening the recovered copy. Backup remains untouched; no overwrite of an existing document. Stale known bindings are reported, never silently repaired.

Input parameters:

- `backup_path` (string, required)
- `path` (string, required)

### `numbers_move` (~97 tokens)

Move/rename an identified native document AND its chart companion to a NEW path. Saves/closes only that source, copies/verifies both files, opens destination, then removes originals only if unchanged and still closed. Returns new document ID. Partial failures retain recoverable copies; no automatic retry.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `path` (string, required)

### `numbers_documents` (~23 tokens)

List open Numbers documents with native IDs and paths. Does not open files.

### `numbers_templates` (~17 tokens)

List installed Numbers template IDs and localized names.

### `numbers_create` (~48 tokens)

Create and immediately save a native .numbers document at a new absolute path, optionally from a template ID. Does not overwrite.

Input parameters:

- `path` (string, required)
- `template_id` (string)

### `numbers_from_template` (~92 tokens)

Create a NEW native document by copying an existing .numbers prototype file/package and opening the copy. Never saves/changes the source; save or close an open modified prototype first. Preserves native objects/styles/formulas. Copies valid chart companion bindings by default; no automatic discovery of unknown chart references.

Input parameters:

- `copy_bindings` (boolean)
- `path` (string, required)
- `template_path` (string, required)

### `numbers_chart_bind` (~200 tokens)

Register a KNOWN existing chart/source-table relationship for guided updates. Does not create a link or introspect series references. Verify the source visually first. Whole source table, one header row, no footer/filter; 500 cells max. Writes a .numbers-native.json companion. replace_binding explicitly refreshes an existing binding ID/label.

Input parameters:

- `chart` (integer, required)
- `chart_sheet`: Exact name or 1-based index. Duplicate names are rejected; use an index.
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `label` (string, required)
- `orientation` (string)
- `range` (string, required)
- `replace_binding` (string)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_chart_bindings` (~65 tokens)

List saved chart/source bindings from this document companion. These record known relationships, not a discovery of private chart-series references. Updates recheck source/structure.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.

### `numbers_chart_update` (~160 tokens)

Preview (default) or apply a guided source update. Apply requires expected_revision of the SAME request. Optional visual_check before_path/after_path generates native PDF+PNG pairs only on apply. Inspect returned images; no automatic claim that private chart references are correct. Native formats preserved. No type/style/reference editing.

Input parameters:

- `binding` (string, required)
- `data` (array)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `expected_revision` (string)
- `headers` (array)
- `mode` (string, required)
- `preview` (boolean)
- `series` (string)
- `values` (array)
- `visual_check` (object)

### `numbers_chart_profiles` (~32 tokens)

List verified native template chart profiles, data orientation and limits. Availability depends on installed Numbers templates; no document access.

### `numbers_chart_create` (~144 tokens)

Create a NEW .numbers document with one template-linked chart and populated source table. Registers a guided binding in a local companion by default. Use chart_profiles first. Rows: category plus numeric series; scatter X,Y; bubble X,Y,size. Dual-axis/scatter/bubble have FIXED weather/fuel/sales axes: use matching meanings. Template type/styles/internal title remain; title is separate text. Max 100 points, profile-specific series, 500 cells.

Input parameters:

- `data` (array, required)
- `headers` (array, required)
- `managed` (boolean)
- `path` (string, required)
- `profile` (string, required)
- `title` (string)

### `numbers_open` (~39 tokens)

Open an existing .numbers file in Numbers; return its ID. No conversion, no support for encrypted-file password prompts.

Input parameters:

- `path` (string, required)

### `numbers_inspect` (~52 tokens)

Inspect sheets, tables, dimensions and object counts of one document. Does not read every cell.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.

### `numbers_save` (~47 tokens)

Save changes to the existing native Numbers file. Numbers also autosaves edits.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.

### `numbers_close` (~57 tokens)

Close this specific document. Saves by default; save=false explicitly discards unsaved changes.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `save` (boolean)

### `numbers_backup` (~80 tokens)

Save the source document, then copy and verify the native file/package AND any valid chart companion to a NEW .numbers path. Keeps the source open and retargets copied metadata. Never overwrites files.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `path` (string, required)

### `numbers_export` (~76 tokens)

Export a document using Numbers itself to PDF or CSV at a NEW path. Native source remains .numbers. CSV can produce multiple files for multiple tables.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `format` (string, required)
- `path` (string, required)

### `numbers_sheet` (~95 tokens)

Create, rename, delete or activate a sheet. Create needs name; other actions need sheet. Deleting a sheet removes all its contents.

Input parameters:

- `action` (string, required)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `name` (string)
- `sheet`: Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_table` (~211 tokens)

Create, rename, delete or configure a table. Configure can resize (shrinking removes cells), set headers/footers, freeze headers and move the table.

Input parameters:

- `action` (string, required)
- `columns` (integer)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `footer_rows` (integer)
- `freeze_header_columns` (boolean)
- `freeze_header_rows` (boolean)
- `header_columns` (integer)
- `header_rows` (integer)
- `height` (number)
- `locked` (boolean)
- `name` (string)
- `rows` (integer)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table`: Exact name or 1-based index. Duplicate names are rejected; use an index.
- `width` (number)
- `x` (number)
- `y` (number)

### `numbers_read` (~111 tokens)

Read a bounded table-relative A1 range: native values, formatted text, formulas and formats. Max 2,000 cells; paginate larger tables.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `range` (string, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_write` (~177 tokens)

Write a rectangular matrix; preserve compatible native base formats by default and return readback. Strings are literal text; formulas use {formula:"=SUM(A2:A4)"}; dates use {date:ISO-8601}; null clears a value. Explicit strings/dates/booleans choose their type format. Custom format details are not exposed. Max 2,000 cells. Not atomic.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `preserve_format` (boolean)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `start` (string, required)
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `values` (array, required)

### `numbers_format` (~182 tokens)

Format a range using native properties. Colors are RGB arrays in 0..65535. Number-format subtype only: decimal precision, currency symbol, pop-up options and border editing are not exposed.

Input parameters:

- `alignment` (string)
- `background_color` (array)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `font_name` (string)
- `font_size` (number)
- `format` (string)
- `range` (string, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `text_color` (array)
- `text_wrap` (boolean)
- `vertical_alignment` (string)

### `numbers_clear` (~109 tokens)

Clear values only, or values AND styling, in a bounded range. Max 2,000 cells.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `range` (string, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `styling` (boolean)
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_merge` (~106 tokens)

Merge or unmerge a bounded native range. Merging may discard non-leading cell content.

Input parameters:

- `action` (string, required)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `range` (string, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_sort` (~109 tokens)

Sort a native table by one 1-based column index. Headers/footers are handled by Numbers.

Input parameters:

- `column` (integer, required)
- `direction` (string)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_transpose` (~90 tokens)

Transpose a native table; Numbers manages formula references. Changes table structure.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_axis` (~128 tokens)

Insert or delete rows/columns. at and count are 1-based; insert occurs before at. Deletion removes cell content.

Input parameters:

- `action` (string, required)
- `at` (integer, required)
- `axis` (string, required)
- `count` (integer, required)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_dimensions` (~119 tokens)

Set height of rows or width of columns over a 1-based inclusive index interval.

Input parameters:

- `axis` (string, required)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `first` (integer, required)
- `last` (integer, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `size` (number, required)
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_selection` (~101 tokens)

Read selection ranges, or select a range in an explicitly identified table. Selecting changes the active sheet.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `range` (string)
- `sheet`: Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table`: Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_find` (~131 tokens)

Search native formatted text or formulas within a bounded range. Literal text matching; max 2,000 cells and 100 hits.

Input parameters:

- `case_sensitive` (boolean)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `in_formulas` (boolean)
- `query` (string, required)
- `range` (string, required)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `table` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_objects` (~83 tokens)

List existing charts/images/shapes/text items/lines/groups and their native geometry on one sheet. No chart data or series API is exposed by Numbers.

Input parameters:

- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.

### `numbers_object` (~212 tokens)

Create a text item, shape or image; update native geometry, font/color, opacity, rotation and reflection where supported, or delete an object. Charts currently expose geometry only.

Input parameters:

- `action` (string, required)
- `document_id` (string, required): Native document ID returned by open/create/documents. Never a frontmost-document shortcut.
- `font_name` (string)
- `font_size` (number)
- `height` (number)
- `image_path` (string)
- `kind` (string, required)
- `locked` (boolean)
- `object` (integer)
- `opacity` (integer)
- `reflection` (boolean)
- `reflection_value` (number)
- `rotation` (integer)
- `sheet` (required): Exact name or 1-based index. Duplicate names are rejected; use an index.
- `text` (string)
- `text_color` (array)
- `width` (number)
- `x` (number)
- `y` (number)

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/viames-numbers-native/numbers-native#diagnostics

## Score history

- 2026-10-19: 37

## Common questions

### What is the Numbers Native MCP server?

Numbers Native is an MCP server listed in the public MCP registry as io.github.viames/numbers-native. Native Apple Numbers on macOS: formulas, guided charts, guarded edits and CSV. No Excel conversion. This page covers its MCPB bundle (https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb).

### Is the Numbers Native MCP server safe to use?

Numbers Native scores 37 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Numbers Native MCP server expose?

Numbers Native exposes 38 tools: numbers_status, numbers_diagnostics, numbers_edit, numbers_check, numbers_import, and 33 more. Their descriptions and schemas cost roughly 3,951 tokens of context every time the server is loaded.

### What licence is the Numbers Native MCP server under?

Numbers Native declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/viames/numbers-native
- Website: https://viames.github.io/numbers-native/
- Changelog RSS feed: https://verifymcp.io/servers/viames-numbers-native/numbers-native.xml
- Changelog JSON feed: https://verifymcp.io/servers/viames-numbers-native/numbers-native.json
- HTML version of this page: https://verifymcp.io/servers/viames-numbers-native/numbers-native