# Tabellum

> Tabellum is a free MCP server for databases. Bridge assistants to the Tabellum database client; writes need your click in the app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://tabellum.dudko.dev
- **Repository:** https://github.com/dudko-dev/tabellum-mcp-setup
- **MCP Registry name:** dev.dudko/tabellum
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-14

## About

The server is hosted by the running Tabellum desktop app, and this npm package (@dudko.dev/tabellum-mcp, Node.js 24 or later) is a small stdio shim that forwards to it. It reads the app's local port and per-install token from ~/.tabellum/mcp.json, so with the app closed every call answers that Tabellum is not running. The assistant gets the same tools as the app's own agent, so the list follows the app version.

Reads run immediately, while any write, DDL or admin statement is sent with propose_write and waits up to 10 minutes for you to approve the exact SQL in the app. The engine's own SQL parser classifies each statement, and run_read answers needs_approval for anything that is not a read. Drafted SQL appears live in an editor tab, and every call is attributed in the app with a badge and an agent log line.

Beyond querying, tools compare schemas against another connection or a saved snapshot and can generate the migration statements without running them, and they propose dashboards and schema designs for you to review as diffs. Tabellum itself opens PostgreSQL, MySQL and MariaDB, SQL Server, BigQuery, SQLite and MongoDB, with registration free and a key verified offline.

## Features

- **Approval for every write:** propose_write shows the exact SQL in the app and waits for your click.
- **Schema exploration:** List connections, describe schemas and objects, and sample rows where the connection allows it.
- **Read classification:** run_read runs only statements the engine classifies as reads.
- **Schema compare:** Diff connections or snapshots and get migration statements without running them.
- **Dashboards and designs:** Propose dashboards and schema designs that you review as diffs.
- **Live editor drafts:** SQL typed into a tab while you watch, without being run.

## Good for

- Ask an assistant to explore a database schema without exposing credentials
- Draft a query in the editor and review it before running
- Generate a migration from the difference between two schemas
- Propose a dashboard over existing tables
- Review and approve an assistant's data change as exact SQL

## Install

### Claude Code (Terminal)

```sh
claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "tabellum": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
```

## Tools

- `list_connections`: Lists connection names, drivers and read-only flags.
- `describe_schema`: Lists schemas with their object names.
- `describe_object`: Shows columns, indexes, constraints and the CREATE of one object.
- `list_users`: Lists users and roles where available.
- `sample_rows`: Returns up to N rows of a table where the connection shares rows.
- `run_read`: Runs a statement only if it is classified as a read.
- `explain`: Returns the estimated plan of a read.
- `propose_write`: Proposes a write for approval in the app.
- `open_editor_tab`: Opens a query tab bound to a connection.
- `draft_to_editor`: Types SQL into a tab without running it.
- `compare_schemas`: Diffs schemas and can produce migration statements.
- `save_schema_snapshot`: Saves a schema snapshot.
- `list_schema_snapshots`: Lists snapshots.
- `list_dashboards`: Lists dashboards.
- `get_dashboard`: Returns one dashboard.
- `propose_dashboard`: Proposes a dashboard for review.
- `list_designs`: Lists schema designs.
- `get_design`: Returns one design.
- `propose_design`: Proposes a schema design for review.
- `describe_feature`: Describes the file format of a feature.

## FAQ

### Does the app need to be running?

Yes. With Tabellum closed, every call answers that Tabellum is not running.

### Can the assistant change my data on its own?

No. Writes, DDL and admin statements wait for your approval in the app, with a 10-minute timeout.

### Does it expose hosts or users?

list_connections returns names, drivers and read-only flags, with no hosts or users.

### How is it authenticated?

With a per-install token the app generates and the shim reads from ~/.tabellum/mcp.json.

### What does Tabellum cost?

Registration is free and the key lasts 180 days, verified offline.

### Is Tabellum free?

Yes. Tabellum is free to use.

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

Run this command in your terminal: claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp

### What are the best alternatives to Tabellum?

The closest alternatives to Tabellum are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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