Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Numbers Native

MCPB · NUMBERS-NATIVE-0.5.0.MCPB

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

37 Trust /100

Last scanned (1 hour ago)

Scores higher than 74% of MCPB servers

Category Data and Analytics

Trust breakdown (7 categories)

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. How we score → Why this is hard to score →

Supply Chain Security0
  • 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.Unverified
  • 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).Unverified
  • Install-script risk not yet assessed.Unverified
  • 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).Unverified
Provenance & Transparency45
Schema Quality & AI Usability64
  • AI-judged instruction clarity (good).Pass
  • 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. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability observed for 0 of 30 days with no destabilising changes; credit accrues until the full window elapses.Unverified
Tool Coverage78
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 33% of tool parameters carry a description.Partial
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

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.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 19 Oct 26 37

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 19 Oct 2026 · Analysed mcpb/https://github.com/viames/numbers-native/releases/download/v0.5.0/numbers-native-0.5.0.mcpb

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem mcpb
Reason No attestation published

Background: How many MCP packages publish verified provenance →

MCP tools · 38 exposed · ~3,951 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
numbers_axis ~128

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

NameTypeReqDescription
actionstringyes–
atintegeryes–
axisstringyes–
countintegeryes–
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_backup ~80

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
pathstringyes–

No output schema declared.

No examples provided.

numbers_chart_bind ~200

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.

NameTypeReqDescription
chartintegeryes–
chart_sheet––Exact name or 1-based index. Duplicate names are rejected; use an index.
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
labelstringyes–
orientationstring––
rangestringyes–
replace_bindingstring––
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_chart_bindings ~65

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.

No output schema declared.

No examples provided.

numbers_chart_create ~144

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.

NameTypeReqDescription
dataarrayyes–
headersarrayyes–
managedboolean––
pathstringyes–
profilestringyes–
titlestring––

No output schema declared.

No examples provided.

numbers_chart_profiles ~32

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

numbers_chart_update ~160

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.

NameTypeReqDescription
bindingstringyes–
dataarray––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
expected_revisionstring––
headersarray––
modestringyes–
previewboolean––
seriesstring––
valuesarray––
visual_checkobject––

No output schema declared.

No examples provided.

numbers_check ~102

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.

NameTypeReqDescription
checksarray––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
rangesarray––

No output schema declared.

No examples provided.

numbers_clear ~109

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
rangestringyes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
stylingboolean––
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_close ~57

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
saveboolean––

No output schema declared.

No examples provided.

numbers_create ~48

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

NameTypeReqDescription
pathstringyes–
template_idstring––

No output schema declared.

No examples provided.

numbers_diagnostics ~66

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.

NameTypeReqDescription
launchboolean––

No output schema declared.

No examples provided.

numbers_dimensions ~119

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

NameTypeReqDescription
axisstringyes–
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
firstintegeryes–
lastintegeryes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
sizenumberyes–
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_documents ~23

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

numbers_edit ~140

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.

NameTypeReqDescription
checksarray––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
editsarrayyes–
expected_revisionstring––
previewboolean––
saveboolean––

No output schema declared.

No examples provided.

numbers_export ~76

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
formatstringyes–
pathstringyes–

No output schema declared.

No examples provided.

numbers_find ~131

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

NameTypeReqDescription
case_sensitiveboolean––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
in_formulasboolean––
querystringyes–
rangestringyes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_format ~182

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.

NameTypeReqDescription
alignmentstring––
background_colorarray––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
font_namestring––
font_sizenumber––
formatstring––
rangestringyes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.
text_colorarray––
text_wrapboolean––
vertical_alignmentstring––

No output schema declared.

No examples provided.

numbers_from_template ~92

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.

NameTypeReqDescription
copy_bindingsboolean––
pathstringyes–
template_pathstringyes–

No output schema declared.

No examples provided.

numbers_import ~233

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.

NameTypeReqDescription
checksarray––
delimiterstring––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
expected_revisionstring––
key_columnstring––
mappingarrayyes–
modestringyes–
overwrite_formulasboolean––
previewboolean––
saveboolean––
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
source_pathstringyes–
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_inspect ~52

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.

No output schema declared.

No examples provided.

numbers_merge ~106

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

NameTypeReqDescription
actionstringyes–
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
rangestringyes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_move ~97

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
pathstringyes–

No output schema declared.

No examples provided.

numbers_object ~212

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.

NameTypeReqDescription
actionstringyes–
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
font_namestring––
font_sizenumber––
heightnumber––
image_pathstring––
kindstringyes–
lockedboolean––
objectinteger––
opacityinteger––
reflectionboolean––
reflection_valuenumber––
rotationinteger––
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
textstring––
text_colorarray––
widthnumber––
xnumber––
ynumber––

No output schema declared.

No examples provided.

numbers_objects ~83

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_open ~39

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

NameTypeReqDescription
pathstringyes–

No output schema declared.

No examples provided.

numbers_preview ~113

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
max_dimensioninteger––
pageinteger––
pathstringyes–

No output schema declared.

No examples provided.

numbers_read ~111

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
rangestringyes–
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_restore ~65

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.

NameTypeReqDescription
backup_pathstringyes–
pathstringyes–

No output schema declared.

No examples provided.

numbers_save ~47

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.

No output schema declared.

No examples provided.

numbers_selection ~101

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
rangestring––
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.

No output schema declared.

No examples provided.

numbers_sheet ~95

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

NameTypeReqDescription
actionstringyes–
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
namestring––
sheet––Exact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_sort ~109

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

NameTypeReqDescription
columnintegeryes–
directionstring––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_status ~39

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

NameTypeReqDescription
launchboolean––

No output schema declared.

No examples provided.

numbers_table ~211

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

NameTypeReqDescription
actionstringyes–
columnsinteger––
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
footer_rowsinteger––
freeze_header_columnsboolean––
freeze_header_rowsboolean––
header_columnsinteger––
header_rowsinteger––
heightnumber––
lockedboolean––
namestring––
rowsinteger––
sheet–yesExact 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.
widthnumber––
xnumber––
ynumber––

No output schema declared.

No examples provided.

numbers_templates ~17

List installed Numbers template IDs and localized names.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

numbers_transpose ~90

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

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.

No output schema declared.

No examples provided.

numbers_write ~177

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.

NameTypeReqDescription
document_idstringyesNative document ID returned by open/create/documents. Never a frontmost-document shortcut.
preserve_formatboolean––
sheet–yesExact name or 1-based index. Duplicate names are rejected; use an index.
startstringyes–
table–yesExact name or 1-based index. Duplicate names are rejected; use an index.
valuesarrayyes–

No output schema declared.

No examples provided.

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.

mcpb · numbers-native-0.5.0.mcpb

Download bundle

Check the download matches the SHA-256 the MCP registry declares before you open it. If it does not match, do not open the file.

SHA-256

aa8c9d67653d07b52fb2d864c24efe2dbb88f4e4992b0587828fe360c33fd0d8

macOS / Linux

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

Windows (PowerShell)

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

Run it in the folder you saved the bundle to, then open the file with an MCPB-capable host such as Claude Desktop.

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.