# Basis

The Basis MCP server for Claude Code reads Excel workbooks, checks formulas, and supports model edits. It handles requests to inspect workbook data and compare changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: basis1tech
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/basis1tech/basis-oss/tree/HEAD/mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/basis

## What it does

Basis gives an agent tools to inspect Excel workbooks, evaluate formulas, and trace cell dependencies. A workbook can also be opened as a session so the agent can change input values and read the resulting outputs. File inputs accept `path`, `url`, or `base64`.

The server uses the Basis API, and files sent to its tools are uploaded there. Running the package requires Node.js 20.19 or later, a `BASIS_API_KEY`, and a network connection. `npx` fetches the package on its first run. The hosted MCP endpoint cannot access local files through `path`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.basis1.tech/mcp`
- Environment variables: `BASIS_API_KEY`, `BASIS_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env BASIS_API_KEY=<BASIS_API_KEY> --env BASIS_BASE_URL=<BASIS_BASE_URL> --transport stdio mcp -- npx -y @basis1/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.basis1.tech/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://api.basis1.tech/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp --env BASIS_API_KEY=<BASIS_API_KEY> --env BASIS_BASE_URL=<BASIS_BASE_URL> -- npx -y @basis1/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://api.basis1.tech/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@basis1/mcp"
            ],
            "env": {
                "BASIS_API_KEY": "<BASIS_API_KEY>",
                "BASIS_BASE_URL": "<BASIS_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://api.basis1.tech/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@basis1/mcp"
            ],
            "env": {
                "BASIS_API_KEY": "<BASIS_API_KEY>",
                "BASIS_BASE_URL": "<BASIS_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://api.basis1.tech/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e BASIS_API_KEY=<BASIS_API_KEY> -e BASIS_BASE_URL=<BASIS_BASE_URL> mcp npx -y @basis1/mcp
```
Replace <…> with your own values

## When to use it
- inspect the contents of an Excel workbook
- check formulas and trace cell dependencies
- find cell-level changes between two workbooks
- change model inputs and read the resulting values

## Example prompts
- Inspect `model.xlsx` and summarize its workbook structure.
- Check the formulas in `forecast.xlsx` and trace their cell dependencies.
- Compare `before.xlsx` with `after.xlsx` and list changed cells.

## Similar
- [cost-basis-engine](https://affpapa.org/en/nevibecode/skills/cost-basis-engine.md) — skill · 471 installs
- [xlsx](https://affpapa.org/en/nevibecode/skills/xlsx.md) — skill · 187223 installs
- [data-analysis](https://affpapa.org/en/nevibecode/skills/data-analysis.md) — skill · 8300 installs
- [xlsx-manipulation](https://affpapa.org/en/nevibecode/skills/xlsx-manipulation.md) — skill · 6900 installs
- [minimax-xlsx](https://affpapa.org/en/nevibecode/skills/minimax-xlsx.md) — skill · 3900 installs
- [excel-analysis](https://affpapa.org/en/nevibecode/skills/excel-analysis.md) — skill · 3031 installs

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