# Metabase

This MCP server for Claude Code connects an AI agent to Metabase. It reads and edits dashboards and cards, runs SQL queries, and analyzes data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: 1luvc0d3
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/1luvc0d3/metabase-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/1luvc0d3-metabase

## What it does

The server gives an agent tools to read and change Metabase dashboards, cards, and collections. It runs SQL with safeguards against dangerous operations, groups actions into parallel batches or sequential workflows, and records tool calls. Its modes are `read`, `write`, and `full`; access can be controlled per tool, and query results can have selected columns redacted.

A reachable Metabase instance, its URL, and an API key are required. NLQ and insight features use `ANTHROPIC_API_KEY`; the server starts through `npx` with Node.js installed. Queries use SQL rather than MBQL. The server also supports Metabase instances accessed through a VPN and versions older than v0.60.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `METABASE_URL`, `METABASE_API_KEY`, `MCP_MODE`, `ANTHROPIC_API_KEY`, `MCP_REDACT_COLUMNS`, `MCP_REDACT_MODE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env METABASE_URL=<METABASE_URL> --env METABASE_API_KEY=<METABASE_API_KEY> --env MCP_MODE=<MCP_MODE> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env MCP_REDACT_COLUMNS=<MCP_REDACT_COLUMNS> --transport stdio 1luvc0d3-metabase -- npx -y @ai-1luvc0d3/metabase-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add 1luvc0d3-metabase --env METABASE_URL=<METABASE_URL> --env METABASE_API_KEY=<METABASE_API_KEY> --env MCP_MODE=<MCP_MODE> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env MCP_REDACT_COLUMNS=<MCP_REDACT_COLUMNS> -- npx -y @ai-1luvc0d3/metabase-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "1luvc0d3-metabase": {
            "command": "npx",
            "args": [
                "-y",
                "@ai-1luvc0d3/metabase-mcp"
            ],
            "env": {
                "METABASE_URL": "<METABASE_URL>",
                "METABASE_API_KEY": "<METABASE_API_KEY>",
                "MCP_MODE": "<MCP_MODE>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "MCP_REDACT_COLUMNS": "<MCP_REDACT_COLUMNS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "1luvc0d3-metabase": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@ai-1luvc0d3/metabase-mcp"
            ],
            "env": {
                "METABASE_URL": "<METABASE_URL>",
                "METABASE_API_KEY": "<METABASE_API_KEY>",
                "MCP_MODE": "<MCP_MODE>",
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "MCP_REDACT_COLUMNS": "<MCP_REDACT_COLUMNS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e METABASE_URL=<METABASE_URL> -e METABASE_API_KEY=<METABASE_API_KEY> -e MCP_MODE=<MCP_MODE> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e MCP_REDACT_COLUMNS=<MCP_REDACT_COLUMNS> 1luvc0d3-metabase npx -y @ai-1luvc0d3/metabase-mcp
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- read data from Metabase dashboards and cards
- run SQL against a database through an agent
- create a card and add it to a dashboard in one workflow
- restrict tool access and redact result columns
- turn a natural-language question into SQL

## Example prompts
- Show data from the sales dashboard in Metabase.
- Write a SQL query about revenue and explain its results.
- Create a query card and add it to a dashboard.

## Similar
- [metabase-cli](https://affpapa.org/en/nevibecode/skills/metabase-cli.md) — skill · 890 installs
- [metabase-database-metadata](https://affpapa.org/en/nevibecode/skills/metabase-database-metadata.md) — skill · 613 installs
- [metabase-ai-assistant](https://affpapa.org/en/nevibecode/mcp/metabase-ai-assistant.md) — MCP server · ★ 47 repo stars
- [Google BigQuery](https://affpapa.org/en/nevibecode/mcp/google-bigquery.md) — MCP server · 6986 installs
- [ResultRail by LarryBuildsAI](https://affpapa.org/en/nevibecode/mcp/resultrail-by-larrybuildsai.md) — MCP server · 6708 installs
- [cap-rate-signals](https://affpapa.org/en/nevibecode/mcp/cap-rate-signals.md) — MCP server · 6543 installs

## Other versions with the same name
- [Metabase · metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — ★ 50467 repo stars
- [Metabase · easecloudio](https://affpapa.org/en/nevibecode/mcp/easecloudio-metabase.md)

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
