# Bilig WorkPaper

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 35
- Author: proompteng
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/proompteng/bilig
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/bilig-workpaper

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://bilig.proompteng.ai/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http bilig-workpaper https://bilig.proompteng.ai/mcp
```

2. **Platform CLI**
```bash
claude mcp add bilig-workpaper -- npx -y @bilig/workpaper
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add bilig-workpaper --url https://bilig.proompteng.ai/mcp
```

2. **Platform CLI**
```bash
codex mcp add bilig-workpaper -- npx -y @bilig/workpaper
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bilig-workpaper": {
            "url": "https://bilig.proompteng.ai/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bilig-workpaper": {
            "command": "npx",
            "args": [
                "-y",
                "@bilig/workpaper"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bilig-workpaper": {
            "type": "http",
            "url": "https://bilig.proompteng.ai/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bilig-workpaper": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bilig/workpaper"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http bilig-workpaper https://bilig.proompteng.ai/mcp
```

2. **Platform CLI**
```bash
gemini mcp add bilig-workpaper npx -y @bilig/workpaper
```

## When to use it
- 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
- 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.

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4259
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1074
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1051
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 777

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md