MotherDuck CLI

Important: This is a personal project. I am not affiliated with MotherDuck.

Install

Recommended:

curl -LsSf https://dkdc.sh/md-cli/install.sh | sh

Pre-built binaries are available for Linux and macOS via Python (uv). Windows users should install via cargo or use macOS/Linux.

uv:

uv tool install dkdc-md-cli

cargo:

cargo install dkdc-md-cli

Verify installation:

md --version

You can use uvx to run it without installing:

uvx --from dkdc-md-cli md

Authentication

Set a MotherDuck API token via environment variable:

export MOTHERDUCK_TOKEN="your-token-here"

Token resolution order (first non-empty wins):

--token flag (pass - to read from stdin)
motherduck_token
MOTHERDUCK_TOKEN
motherduck_api_key
MOTHERDUCK_API_KEY

Usage

md [--output text|json] [--token TOKEN] [--yes] <command>

Global flags

Flag	Short	Description
`--output`	`-o`	Output format: `text` (default) or `json`
`--token`		API token (overrides env vars; `-` reads from stdin)
`--yes`	`-y`	Skip confirmation prompts

`service-account`

# Create a service account
md service-account create <username>

# Delete a service account (prompts for confirmation)
md service-account delete <username>

`token`

# List tokens for a user
md token list <username>

# Create a new token
md token create <username> --name <name> [--ttl <seconds>] [--token-type <type>]

# Delete a token (prompts for confirmation)
md token delete <username> <token_id>

--ttl: time-to-live in seconds (300–31536000). Omit for no expiration.

--token-type: read-write (default) or read-scaling.

`duckling`

# Get current duckling config
md duckling get <username>

# Set duckling config (at least one override required)
md duckling set <username> [--rw-size <size>] [--rs-size <size>] [--flock-size <n>]

Instance sizes: pulse, standard, jumbo, mega, giga.

Flock size: 0–64. duckling set fetches the current config and merges your overrides, so you only need to specify what you're changing.

`account`

# List active accounts and their ducklings
md account list-active

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dkdc_md_cli-0.2.2.tar.gz (17.3 kB view details)

Uploaded Apr 13, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl (1.8 MB view details)

Uploaded Apr 13, 2026 CPython 3.11+manylinux: glibc 2.34+ x86-64

dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl (1.8 MB view details)

Uploaded Apr 13, 2026 CPython 3.11+manylinux: glibc 2.34+ ARM64

dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl (1.6 MB view details)

Uploaded Apr 13, 2026 CPython 3.11+macOS 11.0+ ARM64

dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl (1.7 MB view details)

Uploaded Apr 13, 2026 CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file dkdc_md_cli-0.2.2.tar.gz.

File metadata

Download URL: dkdc_md_cli-0.2.2.tar.gz
Upload date: Apr 13, 2026
Size: 17.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dkdc_md_cli-0.2.2.tar.gz
Algorithm	Hash digest
SHA256	`c16ef15f6ef27025da2283542cc0ed0a1d1b1c9f0e5769ed71cf2240683bdf0d`
MD5	`5a46b08f01120cdd8c2564a0801ec455`
BLAKE2b-256	`5bdccb7c4a437bdae768c70798d682ae407ec48f2147180a58bbd5090ef01430`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkdc_md_cli-0.2.2.tar.gz:

Publisher: release-python.yml on dkdc-io/md-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dkdc_md_cli-0.2.2.tar.gz
- Subject digest: c16ef15f6ef27025da2283542cc0ed0a1d1b1c9f0e5769ed71cf2240683bdf0d
- Sigstore transparency entry: 1289700357
- Sigstore integration time: Apr 13, 2026
Source repository:
- Permalink: dkdc-io/md-cli@b693d0db34815772a4844eccd13b3319c8ed967b
- Branch / Tag: refs/tags/v0.2.2
- Owner: https://github.com/dkdc-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b693d0db34815772a4844eccd13b3319c8ed967b
- Trigger Event: push

File details

Details for the file dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl.

File metadata

Download URL: dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl
Upload date: Apr 13, 2026
Size: 1.8 MB
Tags: CPython 3.11+, manylinux: glibc 2.34+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl
Algorithm	Hash digest
SHA256	`a2cc83ce112658843dfb94779b4fa86baa8568e838f924c30e5d74b832cd3f48`
MD5	`d1862e87c92c53a720dae737a7b48529`
BLAKE2b-256	`355a5d23b9cf0da705ccb94af09edc62bd54c5a33d3ef797c0b01f8f24b977ce`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl:

Publisher: release-python.yml on dkdc-io/md-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_x86_64.whl
- Subject digest: a2cc83ce112658843dfb94779b4fa86baa8568e838f924c30e5d74b832cd3f48
- Sigstore transparency entry: 1289700726
- Sigstore integration time: Apr 13, 2026
Source repository:
- Permalink: dkdc-io/md-cli@b693d0db34815772a4844eccd13b3319c8ed967b
- Branch / Tag: refs/tags/v0.2.2
- Owner: https://github.com/dkdc-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b693d0db34815772a4844eccd13b3319c8ed967b
- Trigger Event: push

File details

Details for the file dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl.

File metadata

Download URL: dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl
Upload date: Apr 13, 2026
Size: 1.8 MB
Tags: CPython 3.11+, manylinux: glibc 2.34+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl
Algorithm	Hash digest
SHA256	`07c050aad71991ac5e85a4e6f6c372ec796ee30fd285c0baa23e7edf4d7e14ab`
MD5	`dc92328eaa7ca0856050d387a79c6163`
BLAKE2b-256	`8a942741d7a8d7bfc5425d2e2ac0f23c56039d98aa685716c555f35850196b7a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl:

Publisher: release-python.yml on dkdc-io/md-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dkdc_md_cli-0.2.2-cp311-abi3-manylinux_2_34_aarch64.whl
- Subject digest: 07c050aad71991ac5e85a4e6f6c372ec796ee30fd285c0baa23e7edf4d7e14ab
- Sigstore transparency entry: 1289700811
- Sigstore integration time: Apr 13, 2026
Source repository:
- Permalink: dkdc-io/md-cli@b693d0db34815772a4844eccd13b3319c8ed967b
- Branch / Tag: refs/tags/v0.2.2
- Owner: https://github.com/dkdc-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b693d0db34815772a4844eccd13b3319c8ed967b
- Trigger Event: push

File details

Details for the file dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl
Upload date: Apr 13, 2026
Size: 1.6 MB
Tags: CPython 3.11+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`d67e26049825d1f81f0ba73d51d3aa207bdb7811fb209afd585f104d48a0d1d4`
MD5	`e74f5c686657ceab482c6dabfc60da8e`
BLAKE2b-256	`ff6a1c9703316e2241685453cfbc64470f71ef5486b3538462b3ccd0d83a5d6e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: release-python.yml on dkdc-io/md-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dkdc_md_cli-0.2.2-cp311-abi3-macosx_11_0_arm64.whl
- Subject digest: d67e26049825d1f81f0ba73d51d3aa207bdb7811fb209afd585f104d48a0d1d4
- Sigstore transparency entry: 1289700487
- Sigstore integration time: Apr 13, 2026
Source repository:
- Permalink: dkdc-io/md-cli@b693d0db34815772a4844eccd13b3319c8ed967b
- Branch / Tag: refs/tags/v0.2.2
- Owner: https://github.com/dkdc-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b693d0db34815772a4844eccd13b3319c8ed967b
- Trigger Event: push

File details

Details for the file dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl
Upload date: Apr 13, 2026
Size: 1.7 MB
Tags: CPython 3.11+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`573f49ce31d426bf62337895e3c7197a9fd609a2eec91fa0b38552928c4474e2`
MD5	`d8496daff8e50880e6ced616088d3d3d`
BLAKE2b-256	`155df6121441689c9a5a5e8a356f18d450cafe4186aff7e32300144387d79ebd`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: release-python.yml on dkdc-io/md-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dkdc_md_cli-0.2.2-cp311-abi3-macosx_10_12_x86_64.whl
- Subject digest: 573f49ce31d426bf62337895e3c7197a9fd609a2eec91fa0b38552928c4474e2
- Sigstore transparency entry: 1289700607
- Sigstore integration time: Apr 13, 2026
Source repository:
- Permalink: dkdc-io/md-cli@b693d0db34815772a4844eccd13b3319c8ed967b
- Branch / Tag: refs/tags/v0.2.2
- Owner: https://github.com/dkdc-io
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-python.yml@b693d0db34815772a4844eccd13b3319c8ed967b
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.2.2 This release

Apr 13, 2026 5 files

Mar 22, 2026 5 files

Feb 12, 2026 5 files

Feb 12, 2026 5 files

Feb 12, 2026 5 files

Feb 12, 2026 5 files

Feb 12, 2026 5 files

dkdc-md-cli 0.2.2

MotherDuck CLI

Install

Authentication

Usage

Global flags

service-account

token

duckling

account

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed

`service-account`

`token`

`duckling`

`account`