DuckDB MCP Server

A Model Context Protocol (MCP) server that gives AI assistants full access to DuckDB — query local files, S3 buckets, and in-memory data using plain SQL.

Local serverstdio

What is the DuckDB MCP Server?

DuckDB MCP Server is an MCP project maintained in the mustafahasankhan/duckdb-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that gives AI assistants full access to DuckDB — query local files, S3 buckets, and in-memory data using plain…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using duckdb-mcp-server. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
queryExecute any SQL query. Results capped at 10 000 rows.
analyze_schemaDescribe the columns and types of a file or table.
analyze_dataRow count, numeric stats (min/max/avg/median), date ranges, top categorical values.
suggest_visualizationsSuggest chart types and ready-to-run SQL queries based on column types.
create_sessionCreate or reset a session for cross-call context tracking.

How to install the DuckDB MCP Server

{
  "mcpServers": {
    "duckdb": {
      "command": "duckdb-mcp-server",
      "args": [
        "--db-path",
        "~/claude-duckdb/data.db"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.