@arkty/redash-mcp

MCP Server for Redash — execute SQL queries, explore database schemas, and get results as JSON or CSV.

• Ad-hoc queries without creating objects in Redash (no trace left)

• SQL write guard — destructive operations (INSERT/UPDATE/DELETE/DROP) are blocked

• CSV export — saves results to file, returns summary to LLM

• Schema exploration — list tables, search columns, inspect structure

• Default data source — configure once, query without specifying every time

Installation

npx -y @arkty/redash-mcp

Related MCP server: Database Assistant MCP Server

Configuration

Claude Code (.mcp.json)

{
  "mcpServers": {
    "redash": {
      "command": "npx",
      "args": ["-y", "@arkty/redash-mcp"],
      "env": {
        "REDASH_URL": "https://your-redash.example.com",
        "REDASH_API_KEY": "your-api-key",
        "REDASH_DEFAULT_DATA_SOURCE_ID": "1"
      }
    }
  }
}

Environment Variables

Tools

execute_adhoc_query

Execute SQL directly against a data source. No query object is created in Redash. Destructive SQL is blocked.

Parameters: query, data_source_id?, format? ("json" | "csv")

list_data_sources

List all available data sources with IDs, names, and types.

get_data_source_schema

Get full database schema (all tables and columns) for a data source.

Parameters: data_source_id

get_table_info

Get column names and types for a specific table.

Parameters: data_source_id, table_name

search_schema

Search tables and columns by name pattern (case-insensitive).

Parameters: data_source_id, search

Security

• Destructive SQL (INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE, CREATE, etc.) is blocked at the MCP server level. The filter is intentionally simple — it checks for keyword presence in the query text. This means it may produce false positives (e.g., SELECT REPLACE(...) is blocked because REPLACE is a keyword). This is a safety net, not a bulletproof solution.

• Use read-only database credentials in your Redash data source configuration — this is the real protection layer

• API key is passed via environment variable, never hardcoded

License

MIT