Bilig WorkPaper

Community

Run workbook-shaped business rules inside Node with formula readback.

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #158 of 438
Stars: ★ 35 Popular
Transport: stdio (local process) · Streamable HTTP
Runtime: Node.js >=22.0.0 · Docker · Hosted (no local runtime)
Credentials: No credential needed
License: MIT
Last commit: 17 days ago
Tools: 8

57FMRS · C

The Bilig WorkPaper MCP server brings spreadsheet formula calculations to AI agents and Node services, supporting input edits, formula recalculation, JSON persistence, and an MCP tool interface. It is integrated with the official MCP registry and provides both stdio and remote HTTP endpoints. Although not officially maintained, it offers thorough verification paths in its documentation.

Strongest · Maintenance 14/20 Weakest · Reliability 10/20

Reliability

10/20

Security and permissions

13/20

Maintenance

14/20

Documentation

10/20

Setup experience

10/20

Why each score

Reliability 10/20: The README offers extensive reproducible evaluation commands, CI badges (Forgejo/GitHub Actions, CodeQL) and a plausible tool list (list_sheets, read_range, set_cell_contents, etc.), but for the scored object packages/headless/server., the npm package @bilig/headless has no directly attributable committed test or tool-behavior evidence; nearly all evaluators, proofs and docs target the sibling @bilig/workpaper package and cannot be attributed under the rules. Tool/behavior consistency rests on untrusted README text and is unverifiable statically, so a conservative 10: happy path plausible, tests/edge cases not attributable.
Security and permissions 13/20: No red-line signs: local stdio first, formula clinic claims no workbook upload, npm signatures plus SLSA provenance, SECURITY.md and OpenSSF Scorecard present. However the manifest exposes both a remote stateless HTTP endpoint (bilig.proompteng.ai/mcp) and stdio without disclosing the data boundary (workbook contents sent to a remote host), and --writable mode persists edits to the same file with no described confirmation mechanism. No malware or destructive defaults, but permission scoping and data-flow disclosure are incomplete: 13.
Maintenance 14/20: Version 0.164.11 implies a very high release cadence; MIT license, SECURITY.md, SUPPORT.md, contribution guides, discussions, CodeQL, and Scorecard all present. But this static review has no evidence of commit frequency, issue response times, or dependency update practice, and the hyperinflated 0.164.x versioning blurs semantic governance: 14.
Documentation 10/20: The README is exhaustive: install, evaluation paths, tool inventories, disclosed limits (dedicated 'where Bilig is not Excel-compatible yet' doc), troubleshooting, and fixture submission flows. However most content and proofs belong to the sibling @bilig/workpaper package; the scored headless server's own install config, tool parameter schemas, and limits are not documented separately, and sheer volume raises the cost of locating the actual reviewed server. 10.
Setup experience 10/20: A manifest exists with both npm stdio and remote streamable-http transports; README provides one-command npm exec verification, an MCPB bundle, and host config files. But primary install examples point to @bilig/workpaper rather than the manifest's @bilig/headless, and the relationship is unclarified; the remote endpoint entails outbound-data considerations. No execution evidence, so a conservative 10.

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

Scenarios requiring exact cell addresses with computed readback
Formula-driven business logic in backend services
Workbook applications needing JSON persistence

Not for

Visual spreadsheet editing
Office macros or desktop Excel automation
One-off arithmetic calculations

Required permissions

Read and write workbook cells
Export JSON documents locally or remotely

Risks and side effects

Limited formula compatibility; not all Excel functions supported
Embedded XLSX cached values may be inaccurate; use Excel recalculation as oracle

Setup

Before you start

Runtime：Node.js >=22.0.0 · Docker · Hosted (no local runtime)

Launch the server via stdio using the npm package @bilig/headless, or use the remote Streamable HTTP endpoint https://bilig.proompteng.ai/mcp. To configure an MCP client, add the JSON above to your client config file.

claude_desktop_config.json

{
  "mcpServers": {
    "bilig-workpaper": {
      "command": "npx",
      "args": [
        "-y",
        "@bilig/headless"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "bilig-workpaper": {
      "command": "npx",
      "args": [
        "-y",
        "@bilig/headless"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add bilig-workpaper -- npx -y @bilig/headless

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

The client's tool list should show tools like read_cell, set_cell_contents, and export_workpaper_document; you can also run npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp -- and confirm the output shows verified: true.

Troubleshooting

Run bilig-evaluate --door agent-mcp to verify MCP connectivity
Check Node version >=22
Ensure workbook file path is correct

Things to try

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

Read the current values of cells Inputs!B2 and Summary!B2
Set Inputs!B3 to 120 and read back the recalculated value of Summary!B3
Export the current workbook as a WorkPaper JSON document
Analyze this workbook's formula risk and report unsupported functions

Tools 8

read_range read-only

Read cell values from a specified range.

read_cell read-only

Read the value of a single cell.

set_cell_contents writes

Set the contents of a cell and trigger formula recalculation.

set_cell_contents_and_readback writes

Set cell contents and read back the dependent formula result.

get_cell_display_value read-only

Get the display value of a cell.

export_workpaper_document writes

Export the workbook as a JSON document.

validate_formula read-only

Validate the syntax and correctness of a formula.

analyze_workbook_risk read-only

Analyze workbook import/export risks.

Use cases

AI agents editing spreadsheet inputs and reading calculated outputs

Pricing models, quote approvals, payout checks in Node services

Verifying formula correctness in CI/CD tests

Saving and restoring workbook state in workflow automation

Supported clients

Claude Desktop

OpenAI Agents SDK

n8n

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

Overview

Bilig WorkPaper is an MCP server that provides agents formula-workbook read/write and recalculation capabilities. It enables editing input cells, reading formula-computed outputs, persisting workbook state as JSON, and exposing MCP tools for workbook risk preflight. Designed for Node services and AI agents that need to interact with structured formula workbooks.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 413 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.7k · Tools 15 Compare with this →

Compare with other MCP servers

More servers from this repository

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