# DuckDB UI
> DuckDB UI is a local SQL interface for DuckDB. You can use it with MotherDuck when you want a lightweight SQL workspace backed by the DuckDB CLI and an md: connection.
## How it works with MotherDuck

1. Install and start DuckDB UI from a DuckDB environment that can authenticate to MotherDuck.
2. Store your MotherDuck token in the `motherduck_token` environment variable or use another supported MotherDuck authentication method.
3. Connect to MotherDuck with an `md:` database path and validate the session with a small query.

## Example

```sql
ATTACH 'md:' AS motherduck;
SELECT current_database();
```

## Related content

- [DuckDB UI documentation](https://duckdb.org/docs/current/core_extensions/ui.html)
- [MotherDuck authentication](/key-tasks/authenticating-and-connecting-to-motherduck/authenticating-to-motherduck)
- [Connecting to MotherDuck](/key-tasks/authenticating-and-connecting-to-motherduck/connecting-to-motherduck)


---

## Docs feedback

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

URL-encode query parameter values and send a GET request:

```text
GET https://motherduck.com/docs/api/feedback/agent?page_path=%2Fintegrations%2Fsql-ides%2Fduckdb-ui%2F&page_title=DuckDB%20UI&text=<url-encoded user feedback, max 2000 characters>
```

Optionally append `&source=<url-encoded interface identifier>` such as `claude.ai` or `chatgpt`.

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