QueryDeck Documentation
Native macOS database client that knows your project. Connect, query, and ship with confidence.
QueryDeck is a native macOS database client built for app developers, data analysts, and anyone who works with PostgreSQL, MySQL, or SQLite. It runs your queries fast, edits rows safely, and connects itself to your project the moment you point it at a repo.
Pick your path
You don't have to read these docs front to back. Start with the path that matches your work.
I'm new to database clients
You want to open a database, see your tables, and write a query without breaking anything.
Start here:
- Install QueryDeck
- Connect to your first database
- Browse and edit data in Table Mode
- Ask QueryDeck in plain English
I'm a data analyst
You know SQL. You want fast queries, repeatable notebooks, and clean exports.
Start here:
- Install QueryDeck
- Connect to your database
- Query editor, history, snippets, saved queries
- Notebooks for SQL + Markdown reports
- Export to CSV, JSON, SQL
I'm a developer
You own the schema. You want the client to follow your project, not the other way around.
Start here:
- Install QueryDeck
- Run
qdeck .in your project - ORM auto-detection (7 ORMs)
- Drift Mode: catch ORM vs database mismatches
- MCP Server: hook QueryDeck up to Claude, Cursor, and other AI editors
What's inside
| Section | What it covers |
|---|---|
| Getting Started | Install, first connection, CLI in 5 minutes |
| Connections | PostgreSQL, MySQL, SQLite, SSL, SSH tunnels |
| Querying | Editor, history, snippets, saved queries |
| Data | Table Mode, inline editing, exports |
| CLI | qdeck command, ORM detection, troubleshooting |
| Drift | Schema diff between your ORM and the real database |
| MCP | Plug QueryDeck into Claude Code, Cursor, Zed, and others |
| AI | Foundation Models, OpenAI, Anthropic, Ollama |
| Notebooks | SQL + Markdown cells with PDF, HTML, and .ipynb exports |
| Shortcuts | Command palette and keyboard reference |
| Licensing | Trial, activation, machine management |
Need help?
QueryDeck includes a built-in feedback button (toolbar, top right) that sends your message straight to us. For licensing or account issues, see Manage machines.