---
sidebar_position: 5
title: DBeaver
description: Connect DBeaver Community to MotherDuck using the DuckDB database integration.
---

[DBeaver Community](https://dbeaver.io/) is a free cross-platform database integrated development environment (IDE).
It includes a DuckDB integration, so it is a great choice for querying MotherDuck.

## DBeaver DuckDB Setup

DBeaver uses the official [DuckDB JDBC driver](https://duckdb.org/docs/api/java.html), which supports MotherDuck out of the box!
To install DBeaver and the DuckDB driver, first follow the [DuckDB DBeaver guide](https://duckdb.org/docs/guides/sql_editors/dbeaver).
That guide will create a local DuckDB in memory connection.
After completing those steps, follow the steps below to add a MotherDuck connection in addition!

## Connecting DBeaver to MotherDuck

### Browser Authentication

Create a new DuckDB connection in DBeaver.
When entering the connection string in DBeaver, instead of using `:memory:` for an in memory DuckDB, use `md:my_db`.
Replace `my_db` with the name of the target MotherDuck database as needed.

Clicking either "Test Connection" or "Finish" will open the default browser and display an authorization prompt.
Click "Confirm", then return to DBeaver to begin querying MotherDuck!

### Token Authentication

To avoid the authentication prompt when opening DBeaver, a MotherDuck access token can be included as a connection string parameter.

To retrieve a token, follow the steps in [Authenticating to MotherDuck](/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck/authenticating-to-motherduck.md).

Then, create a new DuckDB connection in DBeaver.
Include the token as a query string parameter in the connection string following this format, replacing `<token>` with the access token from the prior step, and `my_db` with the target MotherDuck database:

```sh
md:my_db?motherduck_token=<token>
```

Click "Finish" to begin querying MotherDuck!


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `POST https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

Payload:

```json
{
  "page_path": "/integrations/sql-ides/dbeaver/",
  "page_title": "DBeaver",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed payloads, and `429` when rate-limited.