@twaddan/metabase-mcp

MCP server that connects Claude Code to your Metabase instance — query databases, explore tables, run SQL, and search saved questions.

Quick Start

npx @twaddan/metabase-mcp setup

This will:

1. Prompt for your Metabase URL and API key
2. Validate the connection
3. Register the MCP server with Claude Code
4. Auto-allow all Metabase tools (no permission prompts)

Then just start Claude Code — all Metabase tools are ready.

Available Tools

| Tool | Description | |------|-------------| | list_databases | List all databases connected to Metabase | | list_tables | List all tables in a specific database | | get_table_metadata | Get column names, types, and details for a table | | run_sql_query | Run a native SQL SELECT query against a database | | search_metabase | Search for saved questions, dashboards, tables, and collections | | run_saved_question | Execute a saved question/card by its ID |

Getting a Metabase API Key

1. Log in to your Metabase instance
2. Go to Settings → Authentication → API Keys
3. Click Create API Key
4. Copy the generated key

Manual Setup

If you prefer to configure manually:

claude mcp add -s user \
  -e METABASE_URL=https://metabase.example.com \
  -e METABASE_API_KEY=your_api_key \
  metabase -- npx @twaddan/metabase-mcp

Then add "mcp__metabase" to ~/.claude/settings.json under permissions.allow to skip permission prompts.

Troubleshooting

"METABASE_URL environment variable is required" The MCP server was started without environment variables. Re-run npx @twaddan/metabase-mcp setup or check your Claude Code MCP configuration.

"Could not connect"

• Verify your Metabase URL is accessible from your machine
• Check that the API key is valid and has not expired
• Ensure the URL does not have a trailing slash

Tools not appearing in Claude Code

• Run claude mcp list to verify the server is registered
• Restart Claude Code after setup

License

MIT