Skip to content
MCP server

Showboard

Coding agents answer with dashboards: charts and tables from read-only SQL or spreadsheets

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Web, self-hosted
Runs
Locally
Version
0.4.1
Listing updated
1 day ago

About Showboard

Showboard is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Showboard turns questions asked in a terminal into a dashboard on screen. The agent writes a few read-only SQL queries and a short layout; Showboard runs them, chooses a chart for each result and shows the board, with each number traceable to its query.

Data can be a Postgres database, a SQLite file or a folder of xlsx, xlsm, csv and tsv files. Boards open in the browser at localhost:4710, in a terminal pane beside the agent, or inside your own React 19 app through a mounted handler. Setup commands such as init and doctor write each agent's config and check that it works.

It is built to be safe: Postgres runs in a READ ONLY transaction with time and row limits, only SELECT is accepted, and the handler answers only localhost. Node.js 22.13 or later is required, and it is MIT licensed.

Install

Run in a terminal

claude mcp add showboard --env SHOWBOARD_DB='<SHOWBOARD_DB>' -- npx -y showboard

Add to claude_desktop_config.json

{
  "mcpServers": {
    "showboard": {
      "command": "npx",
      "args": [
        "-y",
        "showboard"
      ],
      "env": {
        "SHOWBOARD_DB": "<SHOWBOARD_DB>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "showboard": {
      "command": "npx",
      "args": [
        "-y",
        "showboard"
      ],
      "env": {
        "SHOWBOARD_DB": "<SHOWBOARD_DB>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "showboard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "showboard"
      ],
      "env": {
        "SHOWBOARD_DB": "<SHOWBOARD_DB>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "showboard": {
      "command": "npx",
      "args": [
        "-y",
        "showboard"
      ],
      "env": {
        "SHOWBOARD_DB": "<SHOWBOARD_DB>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "showboard": {
      "command": "npx",
      "args": [
        "-y",
        "showboard"
      ],
      "env": {
        "SHOWBOARD_DB": "<SHOWBOARD_DB>"
      }
    }
  }
}

Configuration

  • SHOWBOARD_DBA Postgres URL or a SQLite file to answer questions about, opened read-only.

What it does

Read-only SQL
Only SELECT runs, in read-only transactions with limits.
Many sources
Postgres, SQLite, Excel and CSV files.
Automatic charts
Picks a chart type for each query result.
Query traceability
Each number links to its source query.
Embeddable
React components and a handler for your own app.
Setup helpers
Guide, init and doctor commands configure agents.

Good for

  • Ask a question about a database and get a chart
  • Explore a folder of spreadsheets by chat
  • Embed agent-driven reports in an internal app
  • View boards in a terminal pane

Pricing

Open source

MIT licence; free

Showboard FAQ

Which agents are supported?

Claude Code, Codex, Cursor, Gemini CLI and others via init.

Can it modify my data?

No. Queries are SELECT-only, and spreadsheets are only read.

What does it need?

Node.js 22.13 or later; set SHOWBOARD_DB for a database.

What licence?

MIT.

Is Showboard free?

Yes. Showboard is open source, so you can use and self-host it for free.

How do I add Showboard to Claude Code?

Run this command in your terminal: claude mcp add showboard --env SHOWBOARD_DB='<SHOWBOARD_DB>' -- npx -y showboard

What are the best alternatives to Showboard?

The closest alternatives to Showboard are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Showboard

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data