Tabellum — Claude Code MCP server: what it does, how to install
Connects AI assistants to the Tabellum desktop database app. Lets agents inspect schemas and execute reads, while mutations wait for manual approval.
claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcpWhat Tabellum does
This package provides a stdio shim linking your coding agent to an active Tabellum desktop client across PostgreSQL, MySQL, MariaDB, SQL Server, and BigQuery. The agent receives tools to explore schemas, fetch table definitions, inspect indexes, and stream drafted SQL statements into an open editor tab.
Safety is enforced at the parser level. Read statements run directly, but any data modification or schema alteration triggers propose_write and pauses until you approve it inside the desktop UI. Without the Tabellum desktop app running on the host machine, every MCP call fails immediately. Running the bridge package also requires Node.js 24 or newer.
What it helps with
- inspect database schemas, columns, and constraints from the AI session
- execute read-only queries across multiple database drivers
- draft SQL queries directly into an open desktop editor tab
- prevent unauthorized database mutations through mandatory GUI approvals
Example prompts for the agent
- List my active database connections in Tabellum and describe the users table schema.
- Run an explain plan on this select query using the current connection.
- Draft a query to find the top customers by revenue and send it to the Tabellum editor.
How to install Tabellum
Platform CLI
claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcpPlatform CLI
codex mcp add tabellum -- npx -y @dudko.dev/tabellum-mcpConfig file
{
"mcpServers": {
"tabellum": {
"command": "npx",
"args": [
"-y",
"@dudko.dev/tabellum-mcp"
]
}
}
}Config file
{
"servers": {
"tabellum": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dudko.dev/tabellum-mcp"
]
}
}
}Platform CLI
gemini mcp add tabellum npx -y @dudko.dev/tabellum-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tabellum
How do I install Tabellum in Claude Code?
Register the server in your terminal using claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp. Keep the Tabellum desktop application open so the bridge can read the local token.
What does the Tabellum MCP server do?
It acts as a bridge between AI assistants and the Tabellum database client, providing tools for schema inspection, read execution, and SQL drafting.
How are data writes and schema migrations approved?
The parser routes any non-read statement to a dedicated approval queue in the desktop interface, which automatically times out after 10 minutes if left unclicked.
