Bilig WorkPaper — Claude Code MCP server: guide and setup
Runs a headless spreadsheet engine inside Node.js so agents can modify cell inputs, evaluate formulas, and save workbook state to JSON without launching Excel.
claude mcp add --transport http bilig-workpaper https://bilig.proompteng.ai/mcpWhat Bilig WorkPaper does
The server delivers an automated spreadsheet engine with no graphical grid. Models interact with sheets using classic A1 references, validate formula syntax, and run mutations through tools like set_cell_contents_and_readback. Pricing sheets, payout calculators, and forecasting rules compute entirely inside the Node.js runtime.
Executing the package requires Node.js 24 or newer. The public endpoint at https://bilig.proompteng.ai/mcp is restricted to stateless handshake checks, which means confidential workbooks must stay on a local stdio instance instead.
What it helps with
- recalculate spreadsheet formulas without desktop office apps
- validate formula syntax before committing workbook edits
- verify mutated cell outputs against dependent cells
- serialize computational models into portable JSON files
Example prompts for the agent
- Change cell Inputs!B2 to 45 and check the recalculated total in Summary!B2.
- Run validate_formula on =Inputs!B2*Inputs!B3 to confirm the expression syntax.
- Export the active spreadsheet model to JSON using export_workpaper_document.
How to install Bilig WorkPaper
1Platform CLI: remote server
claude mcp add --transport http bilig-workpaper https://bilig.proompteng.ai/mcp2Platform CLI
claude mcp add bilig-workpaper -- npx -y @bilig/workpaper1Platform CLI: remote server
codex mcp add bilig-workpaper --url https://bilig.proompteng.ai/mcp2Platform CLI
codex mcp add bilig-workpaper -- npx -y @bilig/workpaperConfig file
{
"mcpServers": {
"bilig-workpaper": {
"url": "https://bilig.proompteng.ai/mcp"
}
}
}{
"mcpServers": {
"bilig-workpaper": {
"command": "npx",
"args": [
"-y",
"@bilig/workpaper"
]
}
}
}Config file
{
"servers": {
"bilig-workpaper": {
"type": "http",
"url": "https://bilig.proompteng.ai/mcp"
}
}
}{
"servers": {
"bilig-workpaper": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bilig/workpaper"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http bilig-workpaper https://bilig.proompteng.ai/mcp2Platform CLI
gemini mcp add bilig-workpaper npx -y @bilig/workpaperStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Bilig WorkPaper
How do I install Bilig WorkPaper in Claude Code?
To run it locally, run claude mcp add bilig-workpaper -- npx -y @bilig/workpaper. To test via the hosted demo endpoint, use claude mcp add --transport http bilig-workpaper https://bilig.proompteng.ai/mcp.
What does Bilig WorkPaper do?
It provides a headless workbook environment where agents edit cells, evaluate formula trees, and export structured state into JSON without relying on Excel.
Can I send confidential spreadsheets to the hosted endpoint?
No, the hosted HTTP address is intended strictly for stateless connector checks. Private workbook files should run exclusively through a local stdio process.
