Which integrations are available for this server?

Enables integration with the Metabase API to list and access dashboards, questions/cards, and databases, as well as execute SQL queries and retrieve results from specific cards.

How do I use metabase-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@metabase-server show me the results for the 'Monthly Revenue' question" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

metabase-mcp-mbql

Serveur MCP (Model Context Protocol) pour l'intégration avec Metabase, avec support complet de MBQL pour l'édition visuelle des requêtes.

Installation

npm install metabase-mcp-mbql

Configuration MCP

Ajoutez cette configuration à votre client MCP (Claude Desktop, etc.) :

{
  "mcpServers": {
    "metabase": {
      "command": "npx",
      "args": ["metabase-mcp-mbql"],
      "env": {
        "METABASE_URL": "https://metabase.example.com",
        "METABASE_API_KEY": "mb_votre_cle_api"
      }
    }
  }
}

Authentification

Deux méthodes sont supportées :

1. Clé API (recommandé) :

{
  "METABASE_URL": "https://metabase.example.com",
  "METABASE_API_KEY": "mb_votre_cle_api"
}

2. Identifiants utilisateur :

{
  "METABASE_URL": "https://metabase.example.com",
  "METABASE_USERNAME": "votre_email",
  "METABASE_PASSWORD": "votre_mot_de_passe"
}

Outils disponibles

Dashboards

Outil	Description
`list_dashboards`	Liste tous les dashboards
`get_dashboard`	Récupère les détails complets d'un dashboard (cartes, paramètres)
`create_dashboard`	Crée un nouveau dashboard
`update_dashboard`	Met à jour un dashboard existant
`delete_dashboard`	Archive ou supprime un dashboard
`get_dashboard_cards`	Liste toutes les cartes d'un dashboard
`add_card_to_dashboard`	Ajoute une carte à un dashboard
`remove_card_from_dashboard`	Retire une carte d'un dashboard
`update_dashboard_cards`	Met à jour les cartes avec leurs mappings de paramètres
`add_dashboard_filter`	Ajoute ou met à jour un filtre sur un dashboard

Cards (Questions)

Outil	Description
`list_cards`	Liste toutes les questions/cartes (filtres: `archived`, `table`, `database`, `using_model`, `bookmarked`, `using_segment`, `all`, `mine`)
`get_card`	Récupère une carte avec sa configuration complète (dataset_query, template-tags)
`create_card`	Crée une nouvelle question
`update_card`	Met à jour une question existante
`delete_card`	Archive ou supprime une question
`execute_card`	Exécute une question et retourne les résultats

Requêtes MBQL

Outil	Description
`create_card_mbql`	Crée une question en MBQL (éditable dans le query builder visuel)
`execute_mbql_query`	Exécute une requête MBQL sans créer de carte

Requêtes SQL

Outil	Description
`execute_query`	Exécute une requête SQL native sur une base de données

Bases de données

Outil	Description
`list_databases`	Liste toutes les bases de données
`get_database_metadata`	Récupère les métadonnées complètes (tables, champs, IDs)
`get_table_metadata`	Récupère les métadonnées détaillées d'une table

Collections

Outil	Description
`list_collections`	Liste toutes les collections
`create_collection`	Crée une nouvelle collection
`update_collection`	Met à jour une collection

Utilisateurs

Outil	Description
`list_users`	Liste tous les utilisateurs
`get_user`	Récupère les détails d'un utilisateur
`create_user`	Crée un nouvel utilisateur
`update_user`	Met à jour un utilisateur
`disable_user`	Désactive un utilisateur

Permissions

Outil	Description
`list_permission_groups`	Liste les groupes de permissions
`create_permission_group`	Crée un groupe de permissions
`delete_permission_group`	Supprime un groupe de permissions
`get_collection_permissions`	Récupère le graphe des permissions par collection
`update_collection_permissions`	Met à jour les permissions d'un groupe sur une collection
`add_user_to_group`	Ajoute un utilisateur à un groupe
`remove_user_from_group`	Retire un utilisateur d'un groupe

Exemples d'utilisation

Créer une question MBQL

{
  "name": "Ventes par mois",
  "database_id": 1,
  "query": {
    "source-table": 123,
    "aggregation": [["sum", ["field", 456, null]]],
    "breakout": [["field", 789, {"temporal-unit": "month"}]]
  },
  "display": "line"
}

Configurer un filtre avec template-tag

{
  "card_id": 42,
  "dataset_query": {
    "type": "native",
    "database": 1,
    "native": {
      "query": "SELECT * FROM orders WHERE status = {{status}}",
      "template-tags": {
        "status": {
          "id": "abc-123",
          "name": "status",
          "display-name": "Statut",
          "type": "dimension",
          "dimension": ["field", 456, null],
          "widget-type": "category"
        }
      }
    }
  }
}

Connecter un filtre dashboard à une carte

{
  "dashboard_id": 10,
  "cards": [{
    "id": 100,
    "card_id": 42,
    "row": 0,
    "col": 0,
    "size_x": 6,
    "size_y": 4,
    "parameter_mappings": [{
      "parameter_id": "filter-1",
      "card_id": 42,
      "target": ["variable", ["template-tag", "status"]]
    }]
  }]
}

Développement

# Installation des dépendances
npm install

# Build
npm run build

# Watch mode
npm run watch

# Inspector MCP (debug)
npm run inspector

Licence

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

metabase-server