Metabase MCP (headless)

What this does

Metabase MCP (headless) exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

METABASE_URL
METABASE_API_KEY
METABASE_EMAIL
METABASE_PASSWORD
METABASE_READ_ONLY_MODE
METABASE_TOOLSETS
METABASE_TOOLS_ENABLE
METABASE_TOOLS_DISABLE
METABASE_CUSTOM_HEADERS

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install Metabase MCP (headless)?

Run the Claude Code command in the install section to add Metabase MCP (headless) to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with Metabase MCP (headless)?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Metabase MCP (headless) as well.

Does Metabase MCP (headless) need an API key?

Yes. Before it can run, set these environment variables: METABASE_URL, METABASE_API_KEY, METABASE_EMAIL, METABASE_PASSWORD, METABASE_READ_ONLY_MODE, METABASE_TOOLSETS, METABASE_TOOLS_ENABLE, METABASE_TOOLS_DISABLE, METABASE_CUSTOM_HEADERS. They go in the env block of your MCP config.