MCP.so
Sign In
L

Lightdash MCP Server

@poddubnyoleg

Basic information

Category

Data & Analytics

Transports

stdio

Author

poddubnyoleg

Submitted by

pd

About Lightdash MCP Server

MCP server for Lightdash analytics platform. Enables AI assistants like Claude to discover data, execute queries, create charts, and manage dashboards programmatically. Supports Lightdash Cloud and self-hosted instances.

Lightdash MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "lightdash": {
      "command": "uvx",
      "args": [
        "lightdash-mcp"
      ],
      "env": {
        "LIGHTDASH_TOKEN": "<YOUR_TOKEN>",
        "LIGHTDASH_URL": "https://app.lightdash.cloud"
      }
    }
  }
}

Lightdash MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Lightdash Mcp?

Lightdash Mcp is a Model Context Protocol (MCP) server that connects AI assistants like Claude and Cursor to Lightdash analytics. It enables LLMs to discover data, create charts, and manage dashboards programmatically.

How to use Lightdash Mcp?

Install via pip install lightdash-mcp, uvx lightdash-mcp, or pipx run lightdash-mcp. Set environment variables LIGHTDASH_TOKEN and LIGHTDASH_URL, then run lightdash-mcp. Optionally configure Cloudflare Access or Google Cloud IAP. Add the server to MCP clients (e.g., Claude Desktop) by providing the command and environment variables.

Key features of Lightdash Mcp

  • Discovery: explore data catalogs, tables, and schemas
  • Querying: execute queries with filters, metrics, and aggregations
  • Chart management: create, read, update, delete charts
  • Dashboard management: build and manage dashboards with tiles and filters
  • Resource organization: create and manage spaces for content

Use cases of Lightdash Mcp

  • Allow an AI assistant to explore available tables and schemas in Lightdash
  • Automate chart creation and configuration from natural language prompts
  • Duplicate and modify existing dashboards programmatically
  • Run ad-hoc metric queries against any explore in a project
  • Organize analytics content by creating spaces and moving resources

Frequently asked questions

1

How do I obtain a Lightdash token?

Go to **Settings** → **Personal Access Tokens** in your Lightdash instance, click **Generate new token**, and copy the token (starts with `ldt_`).

2

What are the prerequisites?

Python 3.10+, a Lightdash instance (Cloud or self-hosted), and a Lightdash Personal Access Token.

3

How do I handle authentication errors?

Verify your `LIGHTDASH_TOKEN` is correct and starts with `ldt_`, check the token hasn’t expired, and ensure you have the necessary permissions in Lightdash.

4

How do I set up Google Cloud IAP support?

Install with the `[iap]` extra (`pip install lightdash-mcp[iap]`), set `IAP_ENABLED=true`, and ensure the runtime service account has `roles/iam.serviceAccountTokenCreator` on itself and `roles/iap.httpsResourceAccessor` on the Cloud Run service.

5

How can I add a new tool to the server?

Create a new Python file in `lightdash_mcp/tools/` with a `TOOL_DEFINITION` and a `run` function. The server automatically discovers and registers the tool on restart.

Comments

More Data & Analytics MCP servers