# LogiSheets

A local Rust spreadsheet engine that replaces cell coordinates with named tables. Agents build genuine .xlsx files without breaking formulas on row shifts.

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

## What it does

The server runs on your machine. It opens no network sockets. Instead of tracking cell addresses like `B8`, the model manages named tables with keyed rows and labeled columns. You define a calculation rule once per column, and the engine keeps computed cells safe from manual overwrites.

Table schemas and field descriptions stay inside the final `.xlsx` file. A fresh agent session retrieves structures and rules through `list_blocks` and `describe_block` without parsing every single cell. Charts built with `chart_from_block` write native Excel `c:chartSpace` elements that link to fields, staying synchronized when rows change.

Execution requires Node.js with `npx`. Restricting available tools requires defining the `LOGISHEETS_MCP_TOOLS` environment variable at startup.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LOGISHEETS_MCP_TOOLS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LOGISHEETS_MCP_TOOLS=<LOGISHEETS_MCP_TOOLS> --transport stdio logisheets -- npx -y logisheets-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add logisheets --env LOGISHEETS_MCP_TOOLS=<LOGISHEETS_MCP_TOOLS> -- npx -y logisheets-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "logisheets": {
            "command": "npx",
            "args": [
                "-y",
                "logisheets-mcp"
            ],
            "env": {
                "LOGISHEETS_MCP_TOOLS": "<LOGISHEETS_MCP_TOOLS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "logisheets": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "logisheets-mcp"
            ],
            "env": {
                "LOGISHEETS_MCP_TOOLS": "<LOGISHEETS_MCP_TOOLS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LOGISHEETS_MCP_TOOLS=<LOGISHEETS_MCP_TOOLS> logisheets npx -y logisheets-mcp
```
Replace <…> with your own values

## When to use it
- build financial models in .xlsx format without coordinate drift errors
- apply calculation rules across entire table columns in one step
- generate native Excel charts that refresh when source data updates
- inspect workbook schema in later sessions without loading full cell grids

## Example prompts
- Set up a proj block with year and revenue columns, assign margin logic, and write it to model.xlsx
- Convert the raw range in data.xlsx into a structured block using convert_to_block
- Insert a native Excel chart from block rev using chart_from_block

## 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