metabase-mcp-server

A comprehensive MCP server for Metabase with full read/write support -- 46 tools for cards, dashboards, databases, collections, queries, and more.

[](https://www.npmjs.com/package/@ruminaider/metabase-mcp-server) [](LICENSE)

Add to your .mcp.json:

{
  "mcpServers": {
    "metabase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ruminaider/metabase-mcp-server"],
      "env": {
        "METABASE_URL": "https://your-instance.metabaseapp.com",
        "METABASE_API_KEY": "your-api-key"
      }
    }
  }
}

docker build -t metabase-mcp-server .

{
  "mcpServers": {
    "metabase": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "METABASE_URL", "-e", "METABASE_API_KEY", "metabase-mcp-server"],
      "env": {
        "METABASE_URL": "https://your-instance.metabaseapp.com",
        "METABASE_API_KEY": "your-api-key"
      }
    }
  }
}

The server supports three authentication methods, tried in priority order:

| Priority | Method | Environment Variables | Notes | |----------|--------|-----------------------|-------| | 1 | API Key | METABASE_API_KEY | Recommended. Create one in Metabase Admin > Settings > Authentication > API Keys. | | 2 | Session Token | METABASE_SESSION_TOKEN | Short-lived token from the Metabase API (POST /api/session). | | 3 | Email + Password | METABASE_USER_EMAIL + METABASE_PASSWORD | The server exchanges credentials for a session token on startup. |

| Variable | Required | Description | |----------|----------|-------------| | METABASE_URL | Yes | Metabase instance URL (e.g. https://analytics.example.com) | | METABASE_API_KEY | * | API key for authentication | | `METABASE_SESSI