Allocate Internal Tool

Connect your AI client to
Metabase

Access your Metabase dashboards, questions, and collections from any MCP-compatible AI client. Run queries, browse data, search analytics. Set up once, works everywhere.

Set up your client See the tools
Setup

Pick your client, copy the config

Paste the snippet into your client's config file. OAuth sign-in handles the rest.

C

Claude Desktop

Recommended for most users
Requires Node.js 18+ — download the LTS version if you don’t have it
  1. Open Claude Desktop settingsClick the Claude menu → Settings, or press ⌘, (Mac) / Ctrl+, (Windows)
  2. Go to Developer → Edit ConfigClick “Developer” in the left sidebar, then click “Edit Config”. This opens a JSON file in your text editor.
  3. Paste this config and save the file
{ "mcpServers": { "metabase": { "command": "npx", "args": ["mcp-remote", "https://metabase-mcp.internal.allocate.co/mcp"] } } }
4 Restart Claude Desktop — Fully quit (⌘Q on Mac / Alt+F4 on Windows) and reopen. You’ll see a hammer icon in the message bar when connected.
>

Claude Code

Terminal
claude mcp add metabase https://metabase-mcp.internal.allocate.co/mcp
Cu

Cursor

One-click or manual config
Install in Cursor
or add manually
.cursor/mcp.json
{ "mcpServers": { "metabase": { "url": "https://metabase-mcp.internal.allocate.co/mcp" } } }
VS

VS Code

One-click or manual config
Install in VS Code
or add manually
.vscode/mcp.json
{ "servers": { "metabase": { "type": "http", "url": "https://metabase-mcp.internal.allocate.co/mcp" } } }
Cx

Codex CLI

~/.codex/config.toml
[mcp_servers.metabase] url = "https://metabase-mcp.internal.allocate.co/mcp"
G

ChatGPT

Settings → Apps & Connectors

1. Open Settings → Apps & Connectors
2. Click Create
3. Paste the connector URL below

https://metabase-mcp.internal.allocate.co/mcp
How It Works

Three steps, then you're set

1

Add the server

Copy the config snippet above into your AI client's settings.

2

Sign in with Google

A browser window opens for Google sign-in. Only minimal scopes are requested.

3

You're connected

Your AI client can now browse dashboards, run questions, and search your Metabase collections.

Available Tools

6 tools for your analytics

Browse dashboards, run questions, and search your Metabase instance.

Metabase
metabase_list_collections
Browse the Metabase collection tree (folders containing dashboards and questions).
Metabase
metabase_search
Search for dashboards, questions, and collections by name.
Metabase
metabase_get_dashboard
Get dashboard metadata including its cards, filters, and description.
Metabase
metabase_get_question
Get a saved question's definition and metadata.
Metabase
metabase_run_question
Execute a saved question and return results as a markdown table.
Metabase
metabase_run_dashboard_card
Execute a specific card on a dashboard with dashboard filter values applied.
Security

Minimal permissions by design

Only the narrowest Google scopes are requested for sign-in. All Metabase access is read-only.

openid userinfo.email

OAuth 2.1 + PKCE

Proof Key for Code Exchange prevents interception attacks. No client secrets stored on your device.

AES-256-GCM Encryption

Google refresh tokens are encrypted at rest with AES-256-GCM before being stored in the database.

1-Hour Token Expiry

Access tokens expire after one hour. Compromised tokens have a limited window of exposure.