# alephgrid

MCP server for Claude Code provides read-only access to Alephgrid workbooks. Queries table schemas, sheet contents, and SQL datasets without modifying original files.

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

## What it does

Alephgrid grants AI assistants read access to large local datasets stored in DuckDB-backed workbooks. Agents inspect schema cards, read tabular records, and review saved SQL queries directly from active workspaces.

The server operates over HTTP and attaches a verification receipt to every returned query result. Because access requires an active Alephgrid host, the connection fails if the local or remote service is offline.

## Requirements
- Remote server: `https://{alephgrid_host}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http alephgrid https://{alephgrid_host}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add alephgrid --url https://{alephgrid_host}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alephgrid": {
            "url": "https://{alephgrid_host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alephgrid": {
            "type": "http",
            "url": "https://{alephgrid_host}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http alephgrid https://{alephgrid_host}/mcp
```

## When to use it
- query large Parquet and CSV tables directly through an assistant
- inspect workbook schemas and sheet layouts without manual exports
- run read-only SQL queries against DuckDB files from chat
- obtain receipts verifying returned table values

## Example prompts
- Show the schema card for the flights table in Alephgrid.
- Run a SQL query against the orders workbook and return the top five records.
- Read the summary sheet values and include the receipt.

## Similar
- [query](https://affpapa.org/en/nevibecode/skills/query.md) — skill · 1600 installs
- [duckdb-skills](https://affpapa.org/en/nevibecode/plugins/duckdb-skills.md) — plugin · ★ 619 repo stars
- [spreadsheets](https://affpapa.org/en/nevibecode/skills/spreadsheets.md) — skill · 267 installs
- [data-analysis](https://affpapa.org/en/nevibecode/skills/bytedance-data-analysis.md) — skill · 3700 installs
- [Pipetable](https://affpapa.org/en/nevibecode/mcp/pipetable.md) — MCP server · ★ 5 repo stars
- [explore-data](https://affpapa.org/en/nevibecode/skills/explore-data.md) — skill · 6100 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
