Skip to main content
Glama
Sign In
redash-mcp-server

redash-mcp-server

by conekta
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Redash MCP Server

MCP server for the Redash API. Exposes Redash's core data operations as tools for the Model Context Protocol.

Setup

# Install dependencies
uv sync

# Set your Redash API key and URL
export REDASH_API_KEY=your_api_key
export REDASH_URL=https://redash.example.com

# Run the server
uv run python -m redash_mcp

By default the server uses the stdio transport for local MCP clients such as Claude Desktop.

Related MCP server: Edgee MCP Server

Hosted MCP

The server can be deployed as a remote MCP endpoint over Streamable HTTP:

uv run python -m redash_mcp --transport streamable-http

Send your Redash API key in the request header:

Authorization: Key your_api_key

Configuration (Hosted / Streamable HTTP)

If your MCP client supports remote servers over HTTP, the JSON config should include the hosted URL and the Authorization header.

Example:

{
  "mcpServers": {
    "redash": {
      "url": "https://your-mcp-host.com/mcp",
      "headers": {
        "Authorization": "Key your_api_key"
      }
    }
  }
}

Notes:

  • Replace your_api_key with your real Redash API key.

  • The header must be exactly Authorization.

  • The value must include the Key prefix.

Claude Code (CLI)

claude mcp add --transport http redash https://your-mcp-host.com/mcp \
  --header "Authorization: Key your_api_key"

Replace your_api_key with your real Redash API key.

Configuration (Claude Desktop / stdio)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "redash": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/redash-mcp-server", "run", "python", "-m", "redash_mcp"],
      "env": {
        "REDASH_API_KEY": "your_api_key",
        "REDASH_URL": "https://redash.example.com"
      }
    }
  }
}

Available Tools

Resource

Tools

Queries

list_queries, get_query, create_query, update_query, search_queries, get_recent_queries, archive_query, refresh_query

Dashboards

list_dashboards, get_dashboard, create_dashboard, update_dashboard

Data Sources

list_data_sources, get_data_source, get_data_source_schema, check_data_source_connection

Query Results

get_query_result, execute_query

Users

list_users, get_user

Alerts

list_alerts, get_alert, create_alert

Visualizations

list_query_visualizations

Environment Variables

Variable

Description

Default

REDASH_API_KEY

Redash API key (required for stdio transport)

—

REDASH_URL

Base URL of your Redash instance

http://localhost:5000

REDASH_MCP_TRANSPORT

Transport type (stdio or streamable-http)

stdio

REDASH_MCP_HOST

Host to bind HTTP server

127.0.0.1

REDASH_MCP_PORT

Port for HTTP server

8000

REDASH_MCP_STREAMABLE_HTTP_PATH

HTTP path for MCP endpoint

/mcp

Docker

# Build the image
docker build -t redash-mcp .

docker run -i --rm \
  -e REDASH_API_KEY=your_api_key \
  -e REDASH_URL=https://redash.example.com \
  redash-mcp

Configuration (Claude Desktop with Docker / stdio)

{
  "mcpServers": {
    "redash": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "REDASH_API_KEY", "-e", "REDASH_URL", "redash-mcp"],
      "env": {
        "REDASH_API_KEY": "your_api_key",
        "REDASH_URL": "https://redash.example.com"
      }
    }
  }
}

Development

# Install with dev dependencies
uv sync --extra dev

# Run tests
uv run pytest tests/ -v

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • AWS Athena MCP Server

      ColeMurray
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables execution of SQL queries against AWS Athena databases with schema discovery, query status management, and result retrieval through a standardized Model Context Protocol interface.
      67 PyPI
      23
      MIT