Numera MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Numera MCPInspect the workbook budget.numera.json"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Numera MCP
@vectojs/numera-mcp is the safe local-first Model Context Protocol adapter for
Numera workbooks. It lets an MCP client inspect workbooks, read bounded ranges,
and write validated cell batches without launching a browser or subprocess.
The published stdio executable requires Bun.
The server supports .numera.json, .json, .csv, and .xlsx files through
exact-pinned Numera Core and XLSX packages. It is intentionally local and does
not provide collaboration, accounts, cloud storage, or remote network access.
Run
numera-mcp --root /absolute/path/to/workbooksThe server uses stdio. Paths passed to tools are relative to --root. Mutation
tools require an expected input SHA-256 and a distinct, non-existing output
path, so a stale Agent cannot silently overwrite newer work.
Related MCP server: Bilig WorkPaper
Tools
numera_inspect_workbook: return the format, SHA-256, active sheet, sheet dimensions, populated-cell count, and used range.numera_read_range: return raw and display values for at most 10,000 cells.numera_write_cells: validate and atomically apply 1–1,000 typed cell writes to a new output workbook.
Development
bun install
bun run verify
npm pack --dry-runSecurity
See SECURITY.md. Numera MCP treats workbook bytes, formulas, paths, and MCP arguments as untrusted input.
This server cannot be deployed
Maintenance
Related MCP Connectors
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
Excel analytics: inspect, query (JSON rows), charts, and JSON-to-xlsx workbook writing.
Query, join, profile, clean and convert CSV/JSON/Parquet with server-side DuckDB over MCP.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading and searching Excel files through MCP-compatible clients. Provides tools to retrieve workbook metadata, read sheet contents, and search across all sheets using absolute file paths.1MIT
- AlicenseAqualityAmaintenanceHeadless WorkPaper MCP server for spreadsheet formulas, workbook edits, JSON persistence, and verified readback from TypeScript services.736MIT
- FlicenseAqualityCmaintenanceMCP server for Microsoft Office file operations. Read, write, and create Excel, Word, and PowerPoint files directly from your local filesystem.12-
- AlicenseAqualityDmaintenanceEnables reading and writing Excel workbooks (.xlsx) through MCP. Supports listing sheets, tables, pivot tables, reading cell data, exporting to CSV/text/Markdown, and creating/modifying Excel files.14GPL 3.0