Metabase · 1luvc0d3 — Claude Code MCP server: features and setup
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.
MIT ★ 5 updated 2026-11-16
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-mcpWhat Metabase 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.
What it helps with
- 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 for the agent
- 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.
How to install Metabase
Platform CLI
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-mcpReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
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-mcpReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values. 1 more environment variable is in the server README
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 Metabase
How do I install Metabase in Claude Code?
Run `claude mcp add metabase-mcp -e METABASE_URL=<METABASE_URL> -e METABASE_API_KEY=<METABASE_API_KEY> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- npx -y @ai-1luvc0d3/metabase-mcp`. You need the Metabase URL and API keys.
What does the Metabase MCP server do?
It lets an agent read and edit dashboards and cards, run SQL, and combine several operations into a batch or a sequential workflow.
What is required to run the Metabase MCP server?
You need an accessible Metabase instance, METABASE_URL, and METABASE_API_KEY. AI features also require ANTHROPIC_API_KEY, and running through npx requires Node.js.
Similar MCP servers
All MCP servers for Data and databases →Metabase by other authors comes first.