@serdnaley/metabase-mcp weekly downloads statistics

@serdnaley/metabase-mcp

MCP server for Metabase — comprehensive coverage of the Metabase REST API for AI assistants.

Metabase ships a built-in MCP for querying data. This project goes further: 128 tools covering dashboards, questions, collections, users, permissions, alerts, settings, and more — so AI assistants can fully manage Metabase, not just read from it.

Features

• 128 MCP tools across 26 domains: search, databases, tables, collections, cards, dashboards, actions, dataset, users, groups, permissions, segments, revisions, settings, alerts, subscriptions, glossary, documents, timelines, bookmarks, moderation, snippets, x-rays, cache, persistence, uploads • Full CRUD: Create, read, update, delete across all domains • Admin automation: User/group management, permissions, settings, database connections • Read-only mode: Restrict to read-only tools via a single env var • Type-safe: HTTP client generated from Metabase's OpenAPI spec • Two auth modes: API key (recommended) or email/password session • Zero config: Runs via npx — no installation needed

Installation

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

Restart Claude Desktop after saving.

Claude Code (CLI)

Or add to .claude/mcp.json:

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

Restart Cursor after saving.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

Cline (VS Code)

Add to your Cline MCP settings (accessible via the MCP Servers icon):

Continue (VS Code)

Add to .continue/config.yaml:

Zed

Add to your Zed settings.json:

Configuration

| Variable | Required | Description |

| METABASE_URL | Yes | Base URL of your Metabase instance | | METABASE_API_KEY | No* | API key for authentication | | METABASE_EMAIL | No* | Email for session-based auth | | METABASE_PASSWORD | No* | Password for session-based auth | | METABASE_READ_ONLY_MODE | No | Set to true to disable write tools |

*Either METABASE_API_KEY or both METABASE_EMAIL + METABASE_PASSWORD must be provided. API key is recommended.

Getting a Metabase API Key

1. Go to your Metabase instance 2. Click the gear icon > Admin settings > Authentication > API Keys 3. Click "Create API Key" 4. Give it a name and select the appropriate group (e.g., Administrators) 5. Copy the key — it starts with mb_

Examples

"Create a dashboard showing order trends"

The AI assistant will: 1. Use search and get_database_metadata to discover your data 2. Use create_card to create questions (e.g., orders by month, revenue by product) 3. Use create_dashboard to create the dashboard 4. Use update_dashboard_cards to arrange the cards with a layout

"Move all Q4 reports to the Archive collection"

The AI assistant will: 1. Use search to find Q4 report cards 2. Use create_collection to create an Archive collection if needed 3. Use update_card on each card to move it to the new collection

"What tables do we have in the analytics database?"

The AI assistant will: 1. Use list_databases to find the database 2. Use get_database_metadata to list all tables, fields, and relationships

Tools

Read tools (50 — always available)

| Domain | Tools |

| Search | search | | Databases | list_databases, get_database, get_database_metadata, list_database_schemas, get_database_schema | | Tables & Fields | get_table, get_table_query_metadata, get_field, get_field_values | | Collections | list_collections, get_collection, list_collection_items, get_collection_tree | | Cards | list_cards, get_card, execute_card_query | | Dashboards | list_dashboards, get_dashboard | | Actions | list_actions, get_action | | Dataset | execute_query | | Users & Groups | list_users, get_user, get_current_user, list_groups | | Permissions | get_permissions_graph, get_collection_permissions | | Segments | list_segments, get_segment | | Revisions | list_revisions | | Settings | list_settings, get_setting | | Alerts | list_alerts, get_alert, list_dashboard_subscriptions | | Activity | get_activity, list_tasks, get_task | | Snippets | list_snippets, get_snippet | | Glossary | list_glossary_terms, get_glossary_term | | Documents | list_documents, get_document | | Timelines | list_timelines, get_timeline | | Bookmarks | list_bookmarks | | X-Rays | generate_xray | | EID Translation | translate_entity_ids |

Write tools (78 — disabled in read-only mode)

| Domain | Tools |…

Description from the npm listing.