Showboard — Claude Code MCP server: what it does, how to install
Showboard is a Claude Code MCP server that turns SQL queries and spreadsheet data into browser dashboards. It renders charts, summary cards and tables on read-only data.
MIT ★ 7 updated 2026-11-06
claude mcp add showboard -e SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboardWhat Showboard does
The server runs read-only queries against databases or spreadsheets and displays visual dashboards. You can view the output in a web browser at http://localhost:4710 or inside an adjacent terminal via npx showboard pane. Supported inputs include SQLite, PostgreSQL, as well as .xlsx, .xlsm, .csv, and .tsv files.
Showboard enforces read-only access by accepting only SELECT statements. PostgreSQL queries execute inside READ ONLY transactions with strict execution time and row boundaries. The server listens exclusively on localhost and rejects cross-site traffic.
Node.js 22.13 or later is required. Showboard also supports React 19 apps via npm install showboard zod, while configuration for agents is handled with npx showboard init.
What it helps with
- generate charts from local CSV and Excel spreadsheets
- visualize query results from a PostgreSQL database
- inspect SQLite tables through browser-based visual boards
- embed interactive analytical dashboards into a React 19 application
Example prompts for the agent
- Create a chart showing monthly revenue from reports/annual.xlsx
- Build a dashboard with customer signups from shop.sqlite
- Summarize top-selling inventory items from PostgreSQL as a visual board
How to install Showboard
Platform CLI
claude mcp add showboard -e SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboardReplace <…> with your own values
Platform CLI
codex mcp add showboard --env SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboardReplace <…> with your own values
Config file
{
"mcpServers": {
"showboard": {
"command": "npx",
"args": [
"-y",
"showboard"
],
"env": {
"SHOWBOARD_DB": "<SHOWBOARD_DB>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"showboard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"showboard"
],
"env": {
"SHOWBOARD_DB": "<SHOWBOARD_DB>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SHOWBOARD_DB=<SHOWBOARD_DB> showboard npx -y showboardReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Showboard
How to install Showboard in Claude Code?
Run claude mcp add showboard -e SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboard. Replace <SHOWBOARD_DB> with your PostgreSQL connection URL or path to a SQLite database.
What does Showboard do?
It allows coding agents to transform read-only SQL and spreadsheet data into visual dashboards. The boards include charts, tables, and metric cards displayed in a browser or terminal.
What is required to run Showboard?
It requires Node.js 22.13 or higher, along with a database connection string or a folder containing spreadsheet files such as .xlsx or .csv.