Showboard
Coding agents answer with dashboards: charts and tables from read-only SQL or spreadsheets
- 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 showboardAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data