Mcp Metabase Server
A comprehensive MCP server for Metabase with 70+ tools.
A Model Context Protocol (MCP) server for Metabase that gives AI assistants full access to your analytics platform — dashboards, cards, databases, tables, collections, and more.
Developed and maintained by EaseCloud — cloud-native, AI-driven, and data infrastructure solutions.
Quick Start
export METABASE_URL=https://your-metabase-instance.com
export METABASE_API_KEY=your_metabase_api_key
npx @easecloudio/mcp-metabase-server
96 Tools Available
| Domain | Tools |
|---|---|
| Dashboard Management | 27 |
| Card / Question Management | 21 |
| Database Management | 16 |
| Table Management | 17 |
| Collections, Users & Search | 13 |
| Schema Cache (SQL→MBQL) | 2 |
Supported Metabase Versions
- Metabase v0.46.x and above (recommended: v0.48.x or later)
- Metabase Cloud (fully supported)
- Self-hosted instances (Docker, JAR, or cloud deployments)
Installation
npx (Recommended)
npx @easecloudio/mcp-metabase-server
Global install
npm install -g @easecloudio/mcp-metabase-server
mcp-metabase-server
Docker
docker build -t mcp-metabase-server .
docker run -it --rm \
-e METABASE_URL=https://your-metabase-instance.com \
-e METABASE_API_KEY=your_metabase_api_key \
mcp-metabase-server
Configuration
Authentication
API Key (preferred):
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_metabase_api_key
Username / Password (fallback):
METABASE_URL=https://your-metabase-instance.com
METABASE_USERNAME=your_username
METABASE_PASSWORD=your_password
Copy .env.example to .env and fill in your values.
Tool Filtering (TOOL_MODE)
Set TOOL_MODE to control which tools are exposed to the AI. Useful for limiting surface area or preventing accidental writes.
| Mode | Description |
|---|---|
all |
Every available tool (default) |
essential |
Core read + execute tools only |
read |
All non-destructive tools |
write |
All tools including create / update / delete |
TOOL_MODE=essential # smallest surface area
TOOL_MODE=read # read-only
TOOL_MODE=all # everything (default)
Claude Desktop Integration
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Using npx:
{
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASE_URL": "https://your-metabase-instance.com",
"METABASE_API_KEY": "your_metabase_api_key"
}
}
}
}
With tool filtering:
{
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASE_URL": "https://your-metabase-instance.com",
"METABASE_API_KEY": "your_metabase_api_key",
"TOOL_MODE": "essential"
}
}
}
}
Using a local build:
{
"mcpServers": {
"metabase": {
"command": "node",
"args": ["/path/to/metabase-server/dist/index.js"],
"env": {
"METABASE_URL": "https://your-metabase-instance.com",
"METABASE_API_KEY": "your_metabase_api_key"
}
}
}
}
Username / password fallback:
{
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASE_URL": "https://your-metabase-instance.com",
"METABASE_USERNAME": "your_username",
"METABASE_PASSWORD": "your_password"
}
}
}
}
Available Tools
Dashboard Management (27 tools)
From the project's README.