VisuaLeaf Settings & Configuration
Settings is where you manage your license, connect an AI provider, set up email notifications, choose where comparison results are stored, pick a theme and font, let an external AI assistant drive VisuaLeaf, and review crash reports. Everything lives in one dialog with a list of sections down the left side; click a section to show its options on the right, then press Save to keep your changes or Cancel to throw them away.
Get started with Settings:
| Section | What it's for |
|---|---|
| License | Your plan, this computer's activation, and buttons to upgrade, enter a key or activate offline |
| AI Providers | The AI services that write queries and power the assistant |
| Notification emails sent through your own SendGrid account | |
| Storage | Where Data Compare results are saved, and the key that encrypts them |
| Appearance | Theme, interface font, the view results open in, and status bar stats |
| MCP Server | Lets an external AI assistant connect to VisuaLeaf and work in it while you watch |
| Diagnostics | Crash reports saved on this computer, and whether they are sent automatically |
On the desktop app, a General section may also appear with an Ask before quitting switch, which asks you to confirm before VisuaLeaf closes so a stray Cmd+Q doesn't stop running queries. License, MCP Server and Diagnostics are only shown in the desktop app.
The License section shows your plan and this computer's activation at a glance: whether the license is active, which edition you're on, the email it's registered to, this machine's name, the license key (hidden until you click the eye icon), the expiration date, and how many trial days of Pro features you have left. The refresh button next to the edition badge re-checks your license with the server.
Settings is never locked behind a license, so you can always get here to activate, even on a first launch with no connection.
Connect the AI that writes queries for you and powers the assistant. VisuaLeaf can help you write MongoDB queries, aggregation pipelines and SQL, and explain results in plain language. You can add more than one provider and switch between them.
| Field | Description | Required |
|---|---|---|
| Model | The model to use from that provider, such as GPT-4o mini | Yes |
| API key | Your key for that provider. It is hidden by default; click the eye icon to show it | Yes (except local models) |
| Send sample data | Whether a few sample documents or rows are sent along with your field names to make the AI's queries more accurate | No (off by default) |
| Max response tokens | Caps how long an answer can be. Higher allows longer answers but costs more. Default 4096 | No |
The Send sample data switch controls what the AI provider sees:
Send notification emails through your own SendGrid account. Email is off until you turn on Use SendGrid; once it's on, the rest of the fields appear.
| Field | Description | Required |
|---|---|---|
| Use SendGrid | Turns email notifications on or off | N/A |
| API key | Your SendGrid API key (starts with "SG."). Create one in the SendGrid dashboard under Settings > API Keys | Yes, when SendGrid is on |
| From address | The email address messages are sent from. It must be verified in SendGrid | Yes, when SendGrid is on |
| Sender first name / last name | The name shown in the "From" line of the email | No |
Choose where Data Compare results are saved, and manage the key that encrypts them.
~/.visualeaf/compare in your home folder, marked "(default)"Comparison results are encrypted on disk. The key is hidden by default; use the eye icon to show it and Copy to keep a copy somewhere safe. The fingerprint next to the heading lets you check you're using the same key on another machine without revealing it.
Regenerate creates a new key. Results saved under the old key can't be opened without it, so copy the old key first if you might need those results again.
Control how VisuaLeaf looks, how results open, and which icons appear on the left and right activity bars.
Pick Dark (the default) or Light, which is easier on the eyes in daylight and when screen-sharing. The change applies right away across every tab, panel and dialog, and is saved on this device.
Choose the font used across menus, labels and toolbars: Inter, a modern sans-serif, or JetBrains Mono, a classic monospace. Code editors always use JetBrains Mono, whichever you pick here.
Choose the view that new collection, query, aggregation, shell and SQL results open in: Tree (the default), Table (a spreadsheet grid) or JSON (raw documents). Saved queries and restored tabs keep the view they were saved with.
Turn on Status bar stats to show backend memory, frontend memory and CPU meters in the bottom status bar. It's off by default.
Choose which tools appear on the left activity bar, and in what order. Each tool — Visual Schema (ERD), Schema Manager, Data Transfer, Data Compare, Data Sync, Query Profiler and User Management — has a checkbox to show or hide it and up/down arrows to move it. Reset to default restores the original set and order.
You can make the same changes on the bar itself: drag icons to reorder them, or right-click one to hide it. Hidden tools stay available in the Command Palette (Ctrl+K / ⌘+K). Your choices are saved on this device.
Manage the shortcuts pinned to the right activity bar. The list shows your shortcuts top to bottom and how many of the 10 slots you've used.
You can also add shortcuts with the + button on the right bar, and right-click a shortcut there to remove it. Shortcuts are saved on this device.
The MCP Server lets an external AI assistant, such as Claude or another tool that speaks the Model Context Protocol (MCP), connect to VisuaLeaf and drive it: open panels, run queries, manage tasks and more, in this window, while you watch. It is off unless you turn it on, and you can also switch it on or off from the MCP button in the status bar.
Keep the token private. Anyone with it can drive this window. Turning the server off stops access at once, and the status bar shows when the server is running.
Under Allowed access, each group of actions has its own switch and shows how many tools it includes, so you can let an assistant navigate and read without letting it change or delete anything:
If VisuaLeaf's database engine stops unexpectedly, a crash report is saved on this computer. A report holds the error and a short log excerpt; passwords, server and database names, data values, email addresses and your user name are removed before anything is sent.
Changes made in the dialog aren't applied until you click Save at the bottom right. Cancel or the close button discards them. A few switches take effect immediately, such as turning the MCP server on or off and choosing whether crash reports are sent.
Download and start managing your MongoDB and SQL databases with ease.
Download Free Trial