Lightdash Mcp MCP Server

Connect Claude, Cursor, and other AI assistants to your Lightdash analytics using the Model Context Protocol (MCP).

Local serverstdio

What is the Lightdash Mcp Server?

Lightdash Mcp is an MCP project maintained in the poddubnyoleg/lightdash_mcp repository. The maintainer describes its purpose as “Connect Claude, Cursor, and other AI assistants to your Lightdash analytics using the Model Context Protocol (MCP)”. Read the project documentation for the complete scope.

Installation

The documented pypi package is lightdash-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares LIGHTDASH_TOKEN, LIGHTDASH_URL, LIGHTDASH_PROJECT_UUID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

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
list-projectsList all available Lightdash projects
get-projectGet detailed information about a specific project
list-exploresList all available explores/tables in a project
get-explore-schemaGet detailed schema for a specific explore (dimensions, metrics, joins)
list-spacesList all spaces (folders) in the project
get-custom-metricsGet custom metrics defined in the project
list-chartsList all saved charts, optionally filtered by name
search-chartsSearch for charts by name or description
get-chart-detailsGet complete configuration of a specific chart
create-chartCreate a new saved chart with metric query and visualization config
update-chartUpdate an existing chart's configuration (name, description, queries, visualization)
run-chart-queryExecute a saved chart's query and return data
delete-chartDelete a saved chart
list-dashboardsList all dashboards in the project
create-dashboardCreate a new dashboard (empty or with tiles)
duplicate-dashboardClone an existing dashboard with a new name
get-dashboard-tilesGet all tiles from a dashboard with optional full config
get-dashboard-tile-chart-configGet complete chart configuration for a specific dashboard tile
get-dashboard-codeGet the complete dashboard configuration as code
create-dashboard-tileAdd a new tile (chart, markdown, or loom) to a dashboard
update-dashboard-tileUpdate tile properties (position, size, content)
rename-dashboard-tileRename a dashboard tile
delete-dashboard-tileRemove a tile from a dashboard
update-dashboard-filtersUpdate dashboard-level filters
run-dashboard-tilesRun queries for dashboard tiles (supports bulk execution)
run-raw-queryExecute an ad-hoc metric query against any explore
create-spaceCreate a new space to organize charts and dashboards
delete-spaceDelete an empty space

How to install the Lightdash Mcp Server

{
  "mcpServers": {
    "lightdash": {
      "command": "uvx",
      "args": [
        "lightdash-mcp"
      ],
      "env": {
        "LIGHTDASH_TOKEN": "YOUR_LIGHTDASH_TOKEN",
        "LIGHTDASH_URL": "https://app.lightdash.cloud",
        "LIGHTDASH_PROJECT_UUID": "your-project-uuid"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
LIGHTDASH_TOKENDeclared in the maintainer’s client configuration.Check documentation
LIGHTDASH_URLDeclared in the maintainer’s client configuration.Check documentation
LIGHTDASH_PROJECT_UUIDDeclared in the maintainer’s client configuration.Check documentation