Skip to content
MCP server

Tabellum

Bridge assistants to the Tabellum database client; writes need your click in the app

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.2
Listing updated
3 days ago

About Tabellum

Tabellum is a free MCP server for databases. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free key valid 180 days, verified offline; prices for other uses not published

Prices change. Check tabellum.dudko.dev before you buy.

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools