MotherDuck · Codex

Add the MotherDuck / DuckDB MCP server to Codex

SQL analytics over DuckDB and MotherDuck.

Official serverLocalDatabases

1. Add the server

Run in your terminal

# ~/.codex/config.toml
[mcp_servers.motherduck]
command = "uvx"
args = ["mcp-server-motherduck"]

2. Sign in

Run codex mcp login <name> to complete OAuth for a remote server. MotherDuck / DuckDB runs locally; set any credentials MotherDuck asks for before starting Codex.

3. Try it

Ask Codex for something MotherDuck / DuckDB can do. SQL analytics over DuckDB and MotherDuck. Approve the first tool call and check the result before allowing write actions automatically.

· Each server is a [mcp_servers.<name>] table in config.toml.
· Use enabled_tools or disabled_tools to keep the tool list short.

FAQ

How do I add the MotherDuck / DuckDB MCP server to Codex?: Run: # ~/.codex/config.toml …. Run codex mcp login <name> to complete OAuth for a remote server.
Is this the official MotherDuck / DuckDB MCP server?: Yes. It is published by MotherDuck as io.github.motherduckdb/mcp-server-motherduck in the official MCP registry.
Does the MotherDuck / DuckDB MCP server need an API key?: It runs locally from a package. See MotherDuck's docs for any credentials it needs.

Links

MotherDuck MCP docs Codex MCP docs MotherDuck / DuckDB server details

MotherDuck / DuckDB in other clients

Claude Code Gemini CLI Cursor VS Code (GitHub Copilot)

More databases for Codex

Airtable ClickHouse Google Cloud Firestore Google Maps Mapbox MongoDB Neon PlanetScale

Work at MotherDuck?

Feature MotherDuck / DuckDB across the directory and its category from $49/month.

Feature this server

Reviewed Oct 5, 2026. Command generated from the registry record and checked against Codex's documented syntax.