MCP Setup

Rawdash exposes a Model Context Protocol (MCP) server so Claude-powered tools can query your dashboard data as context.

Prerequisites

A running Rawdash server (see OSS Quickstart)
Claude Code or Claude Desktop

Claude Code

Open your project settings

In your project root, open (or create) .claude/settings.json.

Add the Rawdash MCP server

{
  "mcpServers": {
    "rawdash": {
      "command": "npx",
      "args": ["-y", "@rawdash/mcp"],
      "env": {
        "RAWDASH_URL": "http://localhost:3000/api/rawdash"
      }
    }
  }
}

Replace RAWDASH_URL with the URL of your Rawdash server.

Restart Claude Code

Claude Code picks up MCP server changes on restart. After restarting, type /mcp to verify the rawdash server is listed.
Ask questions about your data

Once connected, Claude can query your dashboards directly:

“What were the most active repos last week?”

“Show me open PRs older than 7 days across all repos.”

Claude Desktop

Open the Claude Desktop config file
- macOS
- Windows
Terminal window
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json

Add the Rawdash MCP server

{
  "mcpServers": {
    "rawdash": {
      "command": "npx",
      "args": ["-y", "@rawdash/mcp"],
      "env": {
        "RAWDASH_URL": "https://your-rawdash-server.example.com/api/rawdash"
      }
    }
  }
}

Restart Claude Desktop

The Rawdash tools will appear in the Claude Desktop tools panel after restart.

Available MCP tools

Once connected, Claude has access to these tools:

Tool	Description
`rawdash_list_dashboards`	List all configured dashboards
`rawdash_get_widgets`	Fetch widget data for a dashboard
`rawdash_query`	Run a structured query against a dashboard’s data
`rawdash_health`	Check sync status and last-synced timestamps

Scoping access

By default, the MCP server exposes all dashboards. To restrict access to specific dashboards, pass a RAWDASH_DASHBOARD_IDS env var:

{
  "env": {
    "RAWDASH_URL": "http://localhost:3000/api/rawdash",
    "RAWDASH_DASHBOARD_IDS": "eng,design"
  }
}