# LogiSheets

> LogiSheets is an open-source MCP server for files and documents. Excel-compatible spreadsheet engine for agents: named tables, formulas, real .xlsx. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://docs.logisheets.com
- **Repository:** https://github.com/logisky/logisheets-mcp
- **MCP Registry name:** io.github.logisky/logisheets-mcp
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-16

## About

Agents usually write one formula per cell and track coordinates by hand, so a single off-by-one reference silently breaks a total, and inserting a row shifts everything. This server adds blocks, named tables whose rows have keys and whose columns have names. A field's formula is stated once for the whole column, references say what they mean (the pv field of the row keyed Y3), and the engine owns computed values so a formula cell cannot be overwritten by a number the model worked out.

The schema, field rules and a short description of each block are written into the .xlsx itself, so a later session with no context can call list_blocks and describe_block and learn what the workbook means. convert_to_block adopts an existing table from ordinary cells.

The core tool surface has 32 tools by default, with a full mode adding formatting, comments, links, undo/redo and raw structure operations. It is MIT licensed, runs on your machine and opens no sockets.

## Features

- **Named blocks:** Tables addressed by row keys and column names, not coordinates.
- **Column formulas:** Set a rule once for a whole field.
- **Stable references:** References survive inserted rows and columns.
- **Real .xlsx files:** Reads and writes genuine Excel files.
- **Self-describing workbooks:** Schema and block descriptions stored in the file.
- **Adopt existing tables:** Convert plain cells into a block.
- **Tool surface switch:** Choose core or full tools by environment variable.

## Good for

- Build a financial projection with formulas that stay correct
- Run what-if scenarios without hand-adjusting cells
- Open an emailed spreadsheet and have an agent explain its tables
- Hand a workbook to a later session with no context

## Install

### Claude Code (Terminal)

```sh
claude mcp add logisheets-mcp -- npx -y logisheets-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "logisheets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "logisheets-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "logisheets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "logisheets-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "logisheets-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "logisheets-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "logisheets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "logisheets-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "logisheets-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "logisheets-mcp"
      ]
    }
  }
}
```

## Tools

- `create_block`: Create a named table block with fields
- `set_field_rule`: Set a formula for a whole field
- `add_block_rows`: Add keyed rows to a block
- `describe_block`: Describe a block, its rules and values
- `convert_to_block`: Adopt an existing table of cells as a block
- `list_blocks`: List the blocks in a workbook
- `set_block_description`: Store a description for a block

## FAQ

### Does it produce real Excel files?

Yes, it opens and saves .xlsx.

### What licence is it?

MIT.

### How many tools are there?

32 in the default core mode; set LOGISHEETS_MCP_TOOLS=full for more.

### Does it open network sockets?

No, the README says it runs on your machine and opens no sockets.

### Is LogiSheets free?

Yes. LogiSheets is open source, so you can use and self-host it for free.

### How do I add LogiSheets to Claude Code?

Run this command in your terminal: claude mcp add logisheets-mcp -- npx -y logisheets-mcp

### What are the best alternatives to LogiSheets?

The closest alternatives to LogiSheets are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/logisheets
