# Bilig MCP server

> Lets an AI client read and edit spreadsheet cells, recalculate formulas, and export a WorkPaper JSON document.

- Repository: https://github.com/proompteng/bilig
- Page: https://hostedmcp.org/servers/proompteng/bilig
- Transport: stdio, remote
- Stars: 35
- License: MIT
- Latest version: 1.1.0

## Install

### Claude Code

```sh
claude mcp add bilig -- npx -y @bilig/workpaper
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "bilig": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bilig/workpaper"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"bilig","type":"stdio","command":"npx","args":["-y","@bilig/workpaper"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add bilig -- npx -y @bilig/workpaper
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.bilig]
command = "npx"
args = ["-y", "@bilig/workpaper"]
```

### Gemini CLI

```sh
gemini mcp add -s user bilig npx -- -y @bilig/workpaper
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### What tools does the Bilig MCP server expose?

It exposes tools to list sheets, read ranges and cells, write cell contents with or without readback, get display values, export the WorkPaper document, and validate formulas.

### How do I run the Bilig MCP server locally?

Run the bilig-workpaper-mcp command pointing at a WorkPaper JSON file, optionally initializing a demo workbook and enabling writes.

### Can I use the hosted Bilig MCP endpoint for private workbooks?

No, the hosted endpoint is request-local and meant only for stateless discovery and smoke tests. Use the local stdio path for private or persistent state.

### Does Bilig fully match Excel?

No, Bilig is a headless workbook runtime and does not claim full Excel compatibility. Check the compatibility report if an .xlsx file is your contract.

### Does the Bilig MCP server require authentication?

The README does not describe API keys or OAuth; the documented setup uses a local stdio command with a file path.
