An MCP server that provides access to the Lightdash API, enabling AI assistants to interact with your Lightdash data through a standardized interface.

Installation

Smithery

npx -y @smithery/cli install lightdash-mcp-server --client claude

NPM

npm install lightdash-mcp-server

NPX (Stdio)

npx lightdash-mcp-server

NPX (HTTP)

npx lightdash-mcp-server -port 8080

Configuration

Claude Desktop (Stdio)

{
  "lightdash": {
    "command": "npx",
    "args": [
      "-y",
      "lightdash-mcp-server"
    ],
    "env": {
      "LIGHTDASH_API_KEY": "<your PAT>",
      "LIGHTDASH_API_URL": "https://<your base url>"
    }
  }
}

Claude Desktop (HTTP)

{
  "lightdash": {
    "url": "http://localhost:8080/mcp"
  }
}

Available Tools

Tool	Description
list_projects	Get a list of all projects in your Lightdash organization
get_project	Get detailed information about a specific project
list_spaces	Get a list of all spaces in a project
list_charts	Get a list of all charts in a project
list_dashboards	Get a list of all dashboards in a project
get_custom_metrics	Get custom metrics for a project
get_catalog	Get the catalog for a project
get_metrics_catalog	Get the metrics catalog for a project
get_charts_as_code	Get charts as code for a project
get_dashboards_as_code	Get dashboards as code for a project

Features

• Access to Lightdash projects and their details
• View and manage spaces within projects
• Access to charts and dashboards
• Retrieval of custom metrics and catalog information
• Export charts and dashboards as code
• Support for Stdio and HTTP transport modes
• Lightdash API integration via PAT authentication

Environment Variables

Required

• LIGHTDASH_API_KEY - Your Personal Access Token (PAT) for Lightdash
• LIGHTDASH_API_URL - The base API URL for your Lightdash instance

Notes

Supports two transport modes: Stdio (default) and HTTP. HTTP mode serves requests on the /mcp endpoint and requires setting environment variables on the server side. Includes development scripts and implementation examples for programmatic access.