Server · #97 trending MCP repo · ↗ +57 stars this week
Tabularis
TabularisDB/tabularis
Open-source desktop SQL workspace with 3 built-in database drivers and 26 shipped driver plugins, including SQL Server, DuckDB, ClickHouse and Redis. Built-in MCP server for Claude, Cursor and Devin, SQL notebooks and visual EXPLAIN.
- Stars
- 5.4k
- This week
- +57
- Forks
- 415
- Open issues
- 151
- Skills inside
- 9
Inside this repo
9 skills
.claude/skills/gitnexus/gitnexus-cligitnexus-debuggingUse when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\".claude/skills/gitnexus/gitnexus-debugginggitnexus-exploringUse when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase. Examples: \"How does X work?\", \"What calls this function?\", \"Show me the auth flow\".claude/skills/gitnexus/gitnexus-exploringgitnexus-guideUse when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: \"What GitNexus tools are available?\", \"How do I use GitNexus?\".claude/skills/gitnexus/gitnexus-guidegitnexus-impact-analysisUse when the user wants to know what will break if they change something, or needs safety analysis before editing code. Examples: \"Is it safe to change X?\", \"What depends on this?\", \"What will break?\".claude/skills/gitnexus/gitnexus-impact-analysisgitnexus-refactoringUse when the user wants to rename, extract, split, move, or restructure code safely. Examples: \"Rename this function\", \"Extract this into a module\", \"Refactor this class\", \"Move this to a separate file\".claude/skills/gitnexus/gitnexus-refactoringtabularis-plugin-driverUse when creating or updating a Tabularis database driver plugin in Rust. Covers modern manifest fields, JSON-RPC over stdio, modular plugin layout, MySQL-level feature coverage targets, optional UI extensions, and validation against Tabularis repo rules..claude/skills/tabularis-plugin-drivertabularis-pr-reviewUse when reviewing a Tabularis pull request locally — checking code quality against the repo's own rules, verifying the PR's claims, running its tests on the correct branch, and preparing real test data plus a manual test plan for the human. Use when the user says 'review PR #N', 'lass uns PR review.claude/skills/tabularis-pr-reviewtabularis-run-macosmacOS only. Launch the real Tabularis desktop app (debug build, real WKWebView and Tauri IPC) and drive it from the agent through tauri-wd: click, fill forms, open menus, drag, take window screenshots and check the result on disk. Use to manually verify a PR or a change in the running app without wr.claude/skills/tabularis-run-macosDocumentation
README
Tabularis
Tabularis is an open-source desktop SQL workspace with 3 built-in database drivers and 26 shipped driver plugins, including DuckDB, ClickHouse, Redis and Firestore. Its built-in MCP server lets Claude, Cursor and Devin (formerly Windsurf) read your schema and run queries in the same app you already use.
Website · Docs · Download · Changelog
English · Italiano · Español · 中文 · Français · Deutsch · 日本語 · Русский · Tagalog · 한국어 · Português (Brasil)
Download
winget install Debba.Tabularis # Windows
brew install --cask tabularis # macOS
sudo snap install tabularis # Linux
Or grab an installer directly:
The app UI is available in English, Italian, Spanish, Chinese (Simplified), Chinese (Traditional), French, German, Japanese, Russian, Korean, Tagalog, Portuguese (Brazilian) and Vietnamese.
[!TIP] Discord: Join our Discord server to talk with the maintainers, share feedback, and get help from the community.
Table of Contents
- Why tabularis?
- Installation
- Updates
- Discord
- Changelog
- Features
- Tech Stack
- Development
- Roadmap
- Contributing
- Sponsors and supporters
- Origin Story
- License
Why tabularis?
| tabularis | DBeaver CE | TablePlus | Beekeeper Studio | |
|---|---|---|---|---|
| License | Apache 2.0, free | Apache 2.0, free (Pro is paid) | Commercial | GPLv3 (paid editions) |
| SQL notebooks (SQL + Markdown cells, cross-cell variables, charts) | ✅ | ❌ | ❌ | ❌ |
| Built-in MCP server for AI agents | ✅ | ❌ | ❌ | ❌ |
| Plugins in any language (JSON-RPC over stdio) | ✅ | Java/Eclipse plugins | JavaScript plugins | ❌ |
| AI text-to-SQL with local models (Ollama) | ✅ | Cloud-based AI assistant | ❌ | ❌ |
| Visual EXPLAIN with interactive plan graphs | ✅ | ✅ | ❌ | ❌ |
| Databases out of the box | 3 built-in + 26 driver plugins | 100+ | 20+ | ~10 |
[!NOTE] Comparison as of June 2026; features in other tools may have changed since. If you need dozens of drivers, use DBeaver. Tabularis focuses on doing a few databases well.
Database support
PostgreSQL, MySQL/MariaDB and SQLite ship built in. Everything else is a plugin. The built-in PostgreSQL driver is deprecated in favour of the PostgreSQL plugin, which Tabularis installs automatically. Current coverage, mirroring the driver & plugin coverage on the website:
Shipped
On the bounty board
| Status | Databases |
|---|---|
| In progress | Amazon Redshift, Etcd, Meilisearch, Snowflake, SQL Anywhere |
| Scoped | TiDB |
| Open | Firebird, SurrealDB |
[!NOTE] Shipped drivers are installable from the plugin registry. Everything else is on the bounty board: claim one, sponsor one, or request a database.
Installation
Windows
WinGet (Recommended)
winget install Debba.Tabularis
Direct Download
Download the installer from the Releases page and run it:
tabularis_x.x.x_x64-setup.exe
Follow the on-screen instructions to complete the installation.
macOS
Homebrew (Recommended)
brew install --cask tabularis
Direct Download
Builds from v0.13.1 onward are signed and notarized by Apple, so they open without any extra steps.
Notes for releases before v0.13.1
The notes below only apply to older releases (before v0.13.1) downloaded directly:
- You need to allow accessibility access (Privacy & Security) to the tabularis app. If you are upgrading and already have tabularis on the allowed list, remove it manually before accessibility access can be granted to the new version.
- You may need to run
xattr -c /Applications/tabularis.appafter copying the app to the Applications directory.
Linux (Snap)
sudo snap install tabularis
sudo snap connect tabularis:password-manager-service # allow keychain access for saved credentials
[!IMPORTANT] The
password-manager-serviceinterface is not auto-connected by the Snap Store yet. Without it, saving a connection fails with aPlatform secure storage failureerror.
Linux (Flatpak)
flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark dev.tabularis.Tabularis
Linux (AppImage)
Download the .AppImage file from the Releases page, make it executable and run it:
chmod +x tabularis_x.x.x_amd64.AppImage
./tabularis_x.x.x_amd64.AppImage
Arch Linux (AUR)
yay -S tabularis-bin
Updates
Tabularis checks for updates automatically on startup and notifies you when a new version is available. You can also download the latest version directly from the Releases page.
Discord
Join our Discord server to talk with the maintainers, share feedback, suggest features, or get help from the community.
Changelog
Every release is documented in CHANGELOG.md.
Features
Connection Management
Full reference on tabularis.dev →
- Support for MySQL/MariaDB, PostgreSQL (with multi-schema support) and SQLite, with multi-database selection per connection.
- Save, manage, and clone connection profiles, with optional secure password storage in the system Keychain.
- SSH Tunneling with automatic readiness detection.
- Per-Connection Appearance: override the icon (Lucide, emoji, or custom image) and accent color of each saved connection.
Database Explorer
Full reference on tabularis.dev →
- Tree View: Browse tables, columns, keys, indexes, views, and stored routines, with inline editing from the sidebar.
- ER Diagram: Interactive Entity-Relationship visualization (pan, zoom, layout) with selective table diagram generation.
- Context Actions: Show data, count rows, modify schema, duplicate/delete tables.
- SQL Dump & Import: Export and restore databases with a single flow.
SQL Editor
Full reference on tabularis.dev →
- Monaco Editor with syntax highlighting and auto-completion, in a tabbed interface with isolated connections per tab and resizable split view.
- Multi-Statement Execution: Run All, Run Selected, or pick individual queries. Results appear in separate tabs with independent pagination.
- Smart Query Splitting: Correctly handles stored procedures, functions, and
$$-delimited blocks. - SQL Files: Open, edit, and save
.sql,.psql, and.pgsqlfiles in editor tabs without executing them. - Saved Queries and an AI assist overlay directly in the editor.
SQL Notebooks
Full reference on tabularis.dev →
- Multi-Cell Workspace: Combine SQL and Markdown cells in a single document, with inline results and bar/line/pie charts.
- Cross-Cell Variables: Reference another cell's full result as a table with
{{cell_N}}(expanded to a CTE at run time), plus global@paramNameparameters. - Run All: Sequential execution with stop-on-error option and completion summary.
- Persistence & Export: Auto-saved as
.tabularis-notebookfiles; export as HTML, CSV, or JSON. - Outline panel, drag & drop cell reordering, and AI-generated cell names.
Keyboard Shortcuts
Full reference on tabularis.dev →
- Built-in shortcuts for navigation, editor, and data grid actions, platform-aware (
Cmdon macOS,Ctrlon Windows/Linux). - Fully customizable: Remap any non-locked shortcut from Settings → Keyboard Shortcuts; overrides persist to
keybindings.json. - Hold
Ctrl+Shiftin the sidebar to reveal numbered badges (1–9) for instant connection switching.
Visual Query Builder
Full reference on tabularis.dev →
- Drag-and-Drop: Build queries visually with ReactFlow.
- Visual JOINs: Connect tables to create relationships.
- Advanced Logic: WHERE/HAVING filters, aggregates (COUNT, SUM, AVG), sorting, and limits.
- Real-time SQL: Instant code generation.
Visual EXPLAIN
Full reference on tabularis.dev →
- Interactive Plan Graphs: Inspect execution plans as navigable node graphs instead of raw text.
- Table, Raw, and AI Views: Switch between exact node metrics, original database output, and optional AI-assisted analysis.
- Cross-Database Support: Works with PostgreSQL, MySQL/MariaDB, and SQLite using the best available
EXPLAINformat per driver. - Faster Optimization Loops: Spot expensive scans, estimate gaps, join behavior, and optimizer choices without leaving the editor.
Data Grid
Full reference on tabularis.dev →
- Inline & Batch Editing: Modify cells and commit multiple changes at once; create, delete, and multi-select rows.
- Export: Save results as CSV or JSON, or copy selected rows straight to the clipboard.
- JSON & JSONB Cells: Syntax-highlighted in the grid, with a dedicated editor window (Tree / Monaco / Raw modes).
- Spatial Data: Initial GEOMETRY support for MySQL.
Plugin System
Full reference on tabularis.dev →
Tabularis is hackable with an external plugin system. Plugins are standalone executables that communicate with the app over JSON-RPC 2.0 via stdin/stdout, and can be written in any language.
- Install Plugins: Browse and install community drivers from Settings → Available Plugins, no restart required.
- Manage Drivers: View all registered drivers (built-in and plugins) in Settings → Installed Drivers and uninstall plugins with one click.
- Any Database: Add support for DuckDB, MongoDB, or any other database by writing or installing a plugin.
- Plugin Registry: Official plugins are listed in
plugins/registry.json. - Developer Guide: See
plugins/PLUGIN_GUIDE.mdto build your own driver in any language. - Declarative themes (development): Settings → Appearance supports local packages (Import theme → Local package), previews and personal/VS Code imports without executable plugin activation. See the theme author guide for the separate
tabularis-themeCLI, packaging and release gates; public runtime/tooling rollout is not implied by this development feature.
Logging
- Real-time log viewer in Settings, with level filtering and export to
.logfiles. - Automatically expand and inspect SQL queries in logs.
- CLI Debug Mode: Start with
tabularis --debugfor verbose logging from launch.
Configuration Storage
Full reference on tabularis.dev →
Configuration is stored in ~/.config/tabularis/ (Linux), ~/Library/Application Support/tabularis/ (macOS), or %APPDATA%\tabularis\ (Windows): connection profiles, saved queries, app settings (config.json), custom themes, and per-connection editor preferences. You can move this folder from Settings > Storage (or with the TABULARIS_DATA_DIR environment variable), for example to an iCloud Drive or Dropbox folder to sync connections across machines; installed plugins always stay local. Tabs and queries are restored when you reopen a connection. The wiki covers the full file layout and every config.json option, including custom AI model overrides.
How Follow System works on Linux
On Linux, Follow System reads the XDG desktop settings portal's org.freedesktop.appearance/color-scheme preference and follows its live updates, including GNOME's dark-mode toggle with the standard Adwaita GTK theme. The resolved light/dark theme is applied explicitly to GTK window decorations and the webview. A portal value of 0 (no preference) resolves to light, so switching back to the desktop default cannot reuse the app's previously forced dark theme. If the portal is unavailable or returns an unsupported value, Tabularis falls back to the native window theme, then the browser media query. The default window capability grants core:window:allow-set-theme to allow native theme changes. macOS and Windows use native theme notifications. See the portal specification.
Portal command reads reuse one cached D-Bus connection, while the live watcher keeps its own connection. Failed reads discard the cached connection so the next request can reconnect; failed connection attempts are not cached. The existing two-second command timeout also bounds concurrent requests waiting for the cache.
AI Features (Optional)
Full reference on tabularis.dev →
Optional Text-to-SQL and query explanation powered by OpenAI, Anthropic, MiniMax, OpenRouter, Requesty, Ollama (local models, no API key, full privacy), and any OpenAI-compatible API (Groq, Perplexity, Azure OpenAI, LocalAI, ...). Model lists are fetched from your provider and cached locally; custom models can be configured per provider.
MCP Server: AI Agent Integration
Full reference on tabularis.dev →
Tabularis includes a built-in MCP (Model Context Protocol) server that lets AI agents read your database schema and execute queries directly from their chat interface.
tabularis --mcp
One-click setup for Claude Desktop, Cursor, and Windsurf: open Settings → MCP Server Integration, click Install Config next to your client, and restart it. Manual configuration is covered in the wiki.
Available tools
Once connected, your AI agent can:
| Tool | Description |
|---|---|
list_connections |
List all saved database connections |
list_databases |
List all databases available for a connection |
list_tables |
List tables in a connection (with optional schema filter) |
describe_table |
Get full schema: columns, indexes, foreign keys |
run_query |
Execute any SQL query and return results |
Every tool accepts an optional output_format argument. JSON is the default, preserving the existing response format for all clients. You can choose JSON or TOON as the default under Settings → MCP Server Integration; a tool call's output_format argument overrides that preference. TOON is especially compact for tabular query results passed to an LLM. MCP transport remains JSON-RPC in either mode; only the text inside the tool result changes.
Example prompts
"Show me all tables in my production database and describe the
orderstable"
"Write and run a query to find the top 10 customers by total order value this month"
"Check if there are any missing indexes on the
userstable"
Tech Stack
| Layer | Stack |
|---|---|
| Frontend | React 19, TypeScript, Tailwind CSS v4 |
| Backend | Rust, Tauri v2, SQLx |
Development
Setup
pnpm install
pnpm tauri dev
Build
pnpm tauri build
Roadmap
- Plugin registry platform — OAuth publishing, release sync, download analytics
- SQL Server driver — implementation roadmap & call for contributors
- [Feat]: Allow loading of multiple Databases per connection
- Command Palette
- JSON/JSONB Editor & Viewer
- SQL Formatting / Prettier
- Visual Explain Analyze
- Plugin System
- Query History
- UI design system & visual identity — call for contributors
- Feature: Remote Control
- Data Compare / Diff Tool
- Team Collaboration
- Better SQLite Support
- Better PostgreSQL Support
Contributing
Contributions are welcome, see CONTRIBUTING.md. Good places to start:
- UI design system & visual identity: call for contributors
- Write a driver plugin in any language with the Plugin Guide
Sponsors and supporters
turboSMTP — Professional SMTP relay that delivers your emails straight to the inbox, never to spam
Kilo Code — Open source AI coding agent to build, ship, and iterate faster with 500+ models
OpenAI — Supporting Tabularis through the Codex for Open Source program.
Anthropic — Supporting Tabularis through the Claude for Startups program.Neon — Managed Postgres with database branching, supporting Tabularis through the Neon Open Source Program.
Blacksmith — Faster, cheaper GitHub Actions runners, powering the CI behind Tabularis.
DigitalOcean — Simple, predictable cloud infrastructure for developers and growing teams.Vercel — The platform for the modern web: ship, preview, and scale frontend apps with zero config.
Usero — Feedback becomes code. Automatically.
DevGlobe — Connect your IDE, show up on the globe, and showcase your projects to a community of builders.Tolgee — Open-source localization platform to translate your app in context, without the spreadsheet chaos.
1Password — The password and secrets manager developers trust, free for open-source projects.
JetBrains — Professional developer tools: IntelliJ IDEA, WebStorm, DataGrip and the rest of the All Products Pack.
SignPath — Code signing for open source: signed Windows releases without the certificate bill.
…
Releases