Metabase

v1.0.0Analyticsstable

A comprehensive MCP server for Metabase with 70+ tools.

mcpmcp-servermetabase
Share:
76
Stars
0
Downloads
0
Weekly
0/5

What is Metabase?

Metabase is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive mcp server for metabase with 70+ tools.

A comprehensive MCP server for Metabase with 70+ tools.

This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A comprehensive MCP server for Metabase with 70+ tools.

Use Cases

Interact with Metabase using 70+ available tools.
Query and explore business analytics data.
easecloudio

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-metabase

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Metabase

The Metabase MCP Server by EaseCloud Technologies connects AI assistants to a Metabase analytics instance through 96 structured tools spanning dashboard management, card and question operations, database and table administration, collections, user management, and cross-platform search. It authenticates via Metabase API key or username and password, supports read-only, write-only, essential, and full tool modes, and is compatible with self-hosted Metabase and Metabase Cloud on v0.46.x and above. Analysts and developers use it to query, create, and manage Metabase assets entirely through a conversational AI interface.

Prerequisites

  • A running Metabase instance (self-hosted or Cloud, v0.46.x+, v0.48.x+ recommended)
  • A Metabase API key generated in Admin → Settings → Authentication → API Keys
  • Node.js 18+ or Docker installed
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Generate a Metabase API key

Log in to your Metabase instance as an admin, go to Settings → Authentication → API Keys, and create a new key. Copy it immediately as it is shown only once.

# In Metabase Admin UI:
# Settings → Authentication → API Keys → Create API Key
2

Test with Docker first

Validate that your Metabase URL and API key are working by running the server in Docker before configuring your MCP client.

docker run -it --rm \
  -e METABASE_URL=https://your-metabase.example.com \
  -e METABASE_API_KEY=your_metabase_api_key \
  ghcr.io/easecloudio/mcp-metabase-server:latest
3

Add to your MCP client configuration

Edit your client's config file to register the server with your credentials and preferred TOOL_MODE.

# Edit ~/Library/Application Support/Claude/claude_desktop_config.json
4

Restart your MCP client

Restart Claude Desktop or your MCP client to apply the new configuration. Confirm by listing available tools or asking about your Metabase instance.

"What Metabase tools are available?"
"List all dashboards in Metabase"
5

Run your first analytics query

Ask your AI assistant to execute a Metabase question or export data, combining natural language with the 96 available tools.

"Execute the 'Weekly Active Users' question in Metabase and show me the results"

Metabase Examples

Client configuration

Full claude_desktop_config.json entry for the Metabase MCP server using API key authentication:

{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["-y", "@easecloudio/mcp-metabase-server"],
      "env": {
        "METABASE_URL": "https://your-metabase.example.com",
        "METABASE_API_KEY": "your_metabase_api_key",
        "TOOL_MODE": "all"
      }
    }
  }
}

Prompts to try

Use these prompts once the Metabase MCP server is connected to your AI assistant:

- "List all dashboards in my Metabase and tell me which ones were updated this week"
- "Run the 'Revenue by Region' question and export the results as CSV"
- "Create a new dashboard called 'Q4 Sales KPIs' in the Marketing collection"
- "Show me all database connections in Metabase and which ones are currently active"
- "Search for any saved questions related to retention or churn"

Troubleshooting Metabase

Connection refused or timeout when connecting to Metabase

Verify METABASE_URL is the full URL including scheme (https://), no trailing slash, and is reachable from the machine running the MCP server. If Metabase is behind a VPN, the MCP server host must also be on that VPN.

401 Unauthorized errors on every tool call

API keys are tied to a specific Metabase instance and user. Re-generate the key in your Metabase admin panel and update METABASE_API_KEY. As a fallback, use METABASE_USERNAME and METABASE_PASSWORD instead.

Only read tools appear — write operations are missing

Set TOOL_MODE=all in the environment to expose all 96 tools. With TOOL_MODE=read only safe read operations are available, and write/admin tools are omitted.

Frequently Asked Questions about Metabase

What is Metabase?

Metabase is a Model Context Protocol (MCP) server that comprehensive mcp server for metabase with 70+ tools. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Metabase?

Follow the installation instructions on the Metabase GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Metabase?

Metabase works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Metabase free to use?

Yes, Metabase is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Analytics MCP Servers

Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-metabase": { "command": "npx", "args": ["-y", "mcp-metabase"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Metabase?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides