← Back to directory
B

Bilig WorkPaper Server

Community
Formula readback, input edits, JSON persistence, and workbook risk preflight for agents.
Category
Other #25 of 230
Stars
★ 35 Popular
Transport
stdio (local process) · Streamable HTTP
Runtime
Node.js 22+ · Hosted (no local runtime)
Credentials
No credential needed
License
MIT
Last commit
Tools
8
67FMRS · C

Bilig WorkPaper provides a unique way for agents and Node services to handle formula-driven workbooks without a spreadsheet UI. It offers verified read/write/readback and JSON persistence, making it useful for workflows like pricing and approvals. However, it does not claim full Excel compatibility, and accuracy depends on its own formula engine.

Strongest · Documentation 16/20 Weakest · Reliability 10/20

Reliability
10/20
Security and permissions
14/20
Maintenance
14/20
Documentation
16/20
Setup experience
13/20
Why each score
Reliability 10/20
The manifest lists no tool schemas; the tool set claimed in the README (list_sheets, read_range, set_cell_contents, analyze_workbook_risk, etc.) cannot be verified against source or committed tests. README and npm metadata are untrusted. CI/CodeQL/Scorecard badges are claimed but no verifiable evidence covers this server's key paths, so static calibration caps below 12; happy path is plausible but error handling evidence is thin, deducted to 10.
Security and permissions 14/20
No malware, credential theft, or covert exfiltration found; formula clinic claims no uploads and the remote endpoint is stateless JSON-only. However, --writable overwrites persisted files, and data boundaries/confirmation for remote use are not shown in source material; permissions and confirmation scoping incomplete, deducted to 14.
Maintenance 14/20
Version 0.164.11 indicates frequent releases; MIT license, SECURITY.md, SLSA provenance, and OpenSSF Scorecard are referenced. But 35 stars, 0 open issues, and only claims—no verifiable commit/issue-response evidence—so deducted to 14.
Documentation 16/20
README is extensively layered: install, evaluation paths, disclosed limitations (Excel parity boundary, excelParity not_proven), troubleshooting, and security policy. However much content targets the monorepo rather than the reviewed server, and per-tool parameter docs are absent from supplied material, deducted to 16.
Setup experience 13/20
Clear install paths: npm package with stdio, remote streamable-http URL, MCPB bundle, and host config index. But concrete mainstream-client config snippets are not directly shown, and no verifiable execution evidence exists, deducted to 13.

Static review · not runListed 2026-09-08

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local files

Best for

  • Node.js services that want to own backend workbook calculations without a UI.
  • AI agents that need tools to interact with spreadsheets with formula readback.

Not for

  • Use cases requiring a visual spreadsheet interface or Office macros.
  • Workflows that require exact Excel parity.

Required permissions

  • Read and write workbook inputs and formulas.
  • Write access to a specified WorkPaper JSON file if persistence is used.
  • No authentication is required for the hosted mode.

Risks and side effects

  • Formula compatibility is limited; some formulas may be unsupported.
  • Persistence in file-based mode could overwrite unexpected files if the path is misconfigured.
  • Embedded XLSX formulas might not be trustworthy; use Excel oracle for accuracy.

Setup

Before you start

Runtime:Node.js 22+ · Hosted (no local runtime)

Run the local stdio server: npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp. For a hosted HTTP endpoint, use https://bilig.proompteng.ai/mcp. Before use, verify the npm package's SLSA provenance: npm view @bilig/workpaper version dist.attestations --json.

Check that it works

Run npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --; when it returns verified: true and the client's tool list shows list_sheets, read_range, set_cell_contents, and the other WorkPaper tools, the MCP server connection is confirmed.

Troubleshooting

  1. Ensure Node.js version is >=22.
  2. Use `bilig-formula-clinic` to check formula compatibility.
  3. Make sure any XLSX file is handled by appropriate import tools.

Things to try

Once connected, you can ask your AI assistant things like:

  • List all sheets in the current workbook.
  • Read cell Inputs!B2, then set it to 32 and read back the recalculated dependent formula in Summary!B2.
  • Validate the formula in Summary!B7 and show its computed display value.
  • Export the current WorkPaper document as JSON.

Tools 8

list_sheets read-only
List all sheet names in the workbook
read_range read-only
Read a range of cells with values (formula or computed)
read_cell read-only
Read a specific cell's content
set_cell_contents writes
Set the contents of a cell, such as a formula or value
set_cell_contents_and_readback writes
Set a cell's content and read back the recalculated value
get_cell_display_value read-only
Get the display value of a cell
export_workpaper_document read-only
Export the entire WorkPaper JSON document
validate_formula read-only
Validate the syntax of a formula

Use cases

When an agent needs to read and modify a workbook backed by formulas, such as pricing or quote calculations.
Automating approval decisions in workflows with dependent formulas.
Persisting workbook state as JSON for audit or restore.

Supported clients

Claude Desktop
Generic MCP Client

Listed from the project's documentation, not tested by this site.

Overview

The Bilig WorkPaper server is an MCP server that lets AI agents and Node.js services programmatically work with spreadsheet formulas. It enables editing cells, recalculating formulas, reading computed outputs, and persisting workbook state as JSON. This server is designed for 'workbook-shaped' business logic, such as pricing models, quote approval, payout checks, and import validation. It runs headless without Excel, and provides tools like read_range and set_cell_contents_and_readback for cell operations with before/after computed readback. It can be run as a local stdio process (recommended for persistence) or accessed via a hosted HTTP endpoint. Note: it does not claim Excel parity and has known compatibility limitations. The source repository documents these for further review.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 659 · Tools 11 Compare with this →

More servers from this repository

Source revision 49db26b4bcaa Data synced 2026-10-19 Read the FMRS scoring method