# Showboard

> Showboard is an open-source MCP server for files and documents. Coding agents answer with dashboards: charts and tables from read-only SQL or spreadsheets. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted
- **Repository:** https://github.com/rohanbeingsocial/showboard/tree/HEAD/packages/showboard
- **MCP Registry name:** io.github.rohanbeingsocial/showboard
- **Categories:** files and documents, analytics and data, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/showboard
