DataHub MCP Server for Claude

Overview

The DataHub MCP Server is the official Model Context Protocol server from Acryl Data for DataHub — the open source data catalog and metadata platform. It gives Claude structured access to your DataHub instance: search assets, trace lineage, explore schemas, retrieve real SQL queries run against datasets, and enrich metadata through optional mutation tools. Distributed as mcp-server-datahub on PyPI. Apache-2.0 licensed.

Key capabilities

• Asset search — keyword, boolean, and structured search with filters (type, tag, owner, domain).
• Lineage tracing — upstream and downstream data lineage across the full pipeline.
• Lineage path finding — compute lineage paths between two specific assets.
• Query history — retrieve real SQL queries that have been run against a dataset.
• Schema exploration — list and inspect dataset schema fields and column types.
• Batch metadata retrieval — get metadata for multiple assets in one call.
• Document search — keyword and regex search over DataHub knowledge documents.
• Metadata mutation (opt-in) — add/remove tags, glossary terms, owners; opt in via env var.

Tools (key selection)

Configuration options

How it compares

DataHub MCP is unique in exposing real query history — actual SQL that ran against your data, not just schema metadata.

Installation

Claude Code

claude mcp add datahub \
  -e DATAHUB_GMS_URL=https://your-datahub.example.com/api/gms \
  -e DATAHUB_GMS_TOKEN=<your-token> \
  -- uvx mcp-server-datahub

Claude Desktop

{
  "mcpServers": {
    "datahub": {
      "command": "uvx",
      "args": ["mcp-server-datahub"],
      "env": {
        "DATAHUB_GMS_URL": "https://your-datahub.example.com/api/gms",
        "DATAHUB_GMS_TOKEN": "<your-token>"
      }
    }
  }
}

For DataHub Cloud, the GMS URL is typically https://your-org.acryl.io/api/gms.

Requirements

• DataHub instance (self-hosted via Docker Compose or DataHub Cloud).
• Personal access token.
• Python with uvx (from uv).
• An MCP client (Claude Code or Claude Desktop).

Security

• Mutation tools are off by default — only enable TOOLS_IS_MUTATION_ENABLED=true if you need to write tags, terms, or owners.
• Token grants catalog read access; protect it like any API credential.

Source Verification Notes

Verified on 2026-06-18:

• Official repository acryldata/mcp-server-datahub (Apache-2.0) on PyPI as mcp-server-datahub (v0.6.0) documents the DATAHUB_GMS_URL/DATAHUB_GMS_TOKEN configuration, all search/lineage/ query/metadata tools, the optional mutation and semantic search env vars, and the uvx install.
• DataHub feature guide at docs.datahub.com/docs/features/feature-guides/mcp describes the integration setup.
• Claude Code MCP documentation at code.claude.com/docs/en/mcp describes the stdio connector pattern used above.