easecloudio/mcp-metabase-server

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
bash
export METABASEURL=https://your-metabase-instance.com
export METABASEAPIKEY=yourmetabaseapikey
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)
bash
npx @easecloudio/mcp-metabase-server
### Global install
bash
npm install -g @easecloudio/mcp-metabase-server
mcp-metabase-server
### Docker
bash
docker build -t mcp-metabase-server .
docker run -it --rm \
-e METABASEURL=https://your-metabase-instance.com \
-e METABASEAPIKEY=yourmetabaseapikey \
mcp-metabase-server
## Configuration
### Authentication
API Key (preferred):
bash
METABASEURL=https://your-metabase-instance.com
METABASEAPIKEY=yourmetabaseapikey
Username / Password (fallback):
bash
METABASEURL=https://your-metabase-instance.com
METABASEUSERNAME=yourusername
METABASEPASSWORD=yourpassword
Copy .env.example to .env and fill in your values.
### Tool Filtering (TOOLMODE)
Set TOOLMODE 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 |
bash
TOOLMODE=essential # smallest surface area
TOOLMODE=read # read-only
TOOLMODE=all # everything (default)
## Claude Desktop Integration
MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%/Claude/claudedesktopconfig.json
Using npx:
json
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASEURL": "https://your-metabase-instance.com",
"METABASEAPIKEY": "yourmetabaseapikey"
With tool filtering:
json
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASEURL": "https://your-metabase-instance.com",
"METABASEAPIKEY": "yourmetabaseapikey",
"TOOLMODE": "essential"
Using a local build:
json
"mcpServers": {
"metabase": {
"command": "node",
"args": ["/path/to/metabase-server/dist/index.js"],
"env": {
"METABASEURL": "https://your-metabase-instance.com",
"METABASEAPIKEY": "yourmetabaseapikey"
Username / password fallback:
json
"mcpServers": {
"metabase": {
"command": "npx",
"args": ["@easecloudio/mcp-metabase-server"],
"env": {
"METABASEURL": "https://your-metabase-instance.com",
"METABASEUSERNAME": "yourusername",
"METABASEPASSWORD": "yourpassword"
## Available Tools
Dashboard Management (27 tools)
### Core CRUD
| Tool | Description |
| listdashboards | List all dashboards |