MotherDuck logo
Developer ToolsAuth: Bearer token

MotherDuck MCP Server

Connect MotherDuck to your AI agents with the MotherDuck MCP server.

Updated

What is MotherDuck MCP?

The MotherDuck MCP server is a Model Context Protocol server that connects MotherDuck to AI agents and assistants as a set of tools. With it connected, an agent can work with MotherDuck (duckdb-powered cloud data warehouse — run sql queries and analytics) directly — instead of you copying data in and out by hand.

It is a remote MCP server that uses a bearer token, so you point your client at the server URL, authorize once, and the MotherDuck tools become available to the model.

Connect the MotherDuck MCP server

Connect MotherDuck MCP to Claude Code

  1. 1

    Add the server

    Use `claude mcp add` with the MotherDuck MCP server URL (or its `npx` command), following the official docs.

  2. 2

    Authorize

    Complete authentication (a bearer token) so Claude Code can call the server.

  3. 3

    Verify

    Ask Claude to use a MotherDuck tool to confirm the connection is live.

Connect MotherDuck MCP to Cursor

  1. 1

    Open MCP settings

    In Cursor, go to Settings → MCP → Add new server.

  2. 2

    Add MotherDuck

    Provide the MotherDuck MCP server URL or command and complete authentication.

  3. 3

    Test

    Reference MotherDuck from chat to confirm Cursor can reach the tools.

Using MotherDuck MCP with Gamut

On Gamut, the MotherDuck MCP server becomes a tool your agents use inside an automated, event-driven workflow — triggered by an event or a schedule, acting through MotherDuck and your other connected MCP servers, with the connection managed by Gamut rather than a local config file.

Frequently asked questions

What is the MotherDuck MCP server?

It is a Model Context Protocol server that exposes MotherDuck to AI agents as tools so they can work with it (duckdb-powered cloud data warehouse — run sql queries and analytics).

How do I connect the MotherDuck MCP server?

Point your MCP client (Claude, Cursor, or Gamut) at the MotherDuck MCP server URL and complete authentication (a bearer token). See the official documentation for the exact URL and scopes.

Can I use MotherDuck MCP with Gamut?

Yes — Gamut supports the MotherDuck MCP server, so your agents can use it as a tool in automated, triggered workflows.