Skip to content

workpaper

Scoped Bilig WorkPaper runtime and MCP server for Node.js services, agent tools, and server-side spreadsheet formulas.

build.protocol_tooling.mcp#agent-tools#ai-agents#bilig#bilig-workpaper#excel#excel-formulas#exceljs#formula-engine#formula-recalculation#headless-spreadsheet

Install workpaper in your MCP client

workpaper is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add workpaper to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; workpaper's tools should appear.
{
  "mcpServers": {
    "workpaper": {
      "command": "npx",
      "args": [
        "-y",
        "@bilig/workpaper"
      ]
    }
  }
}

Install workpaper in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. workpaper will show up in the assistant's tool list on next launch.

Install workpaper in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). workpaper will show up in the assistant's tool list on next launch.

Install workpaper in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). workpaper will show up in the assistant's tool list on next launch.

Install workpaper in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. workpaper will show up in the assistant's tool list on next launch.

npm package: @bilig/workpaper

Transport

workpaper supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the workpaper README

# @bilig/workpaper Scoped Bilig WorkPaper runtime for Node.js services, agent tools, and server-side spreadsheet formulas. Use this when business logic is easiest to review as workbook cells and formulas, but the calculation needs to run in a backend service, queue worker, serverless route, test, or coding-agent tool. `@bilig/workpaper` is the canonical scoped npm entrypoint. The unscoped `bilig-workpaper` package remains published as a compatibility and search alias. ## Install ```sh npm install @bilig/workpaper ``` ## Use A WorkPaper In Node ```ts import { WorkPaper } from '@bilig/workpaper' const workbook = WorkPaper.buildFromSheets({ Inputs: [ ['Metric', 'Value'], ['Units', 40], ['Price', 1200], ], Summary: [ ['Metric', 'Value'], ['Revenue', '=Inputs!B

Other Model Context Protocol servers in the same space as workpaper. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.