About metabase-cli
metabase-cli is a command-line tool for managing Metabase data and content, aimed at analytics and data-engineering workflows. It combines authentication profiles, content operations, query execution, and Git sync, with bundled skills that document its commands.
Key features
- 01Manage authentication profiles
- 02Inspect databases, schemas, tables, and fields
- 03Create, run, and manage cards and dashboards
- 04Manage transforms, data apps, and settings
- 05Sync content with Git remotes
- 06Validate requests and redact credentials
Use cases
- 01Inspect database structure and trigger schema syncs
- 02Run question queries and export JSON, CSV, or XLSX
- 03Update dashboards, collections, and transforms
- 04Sync Metabase content with a Git remote
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ metabase/ agent-skills --skill metabase-cliAfter installing, type/metabase-cliin Claude Code to confirm it loaded.
Bundled filesREADME.md
Details
From the project READMEmetabase-cli
Load the workflow content from the CLI:
mb skills get core # start here — auth, flag conventions, every command group
mb skills list # enumerate specialized skills bundled with this CLI version
mb skills get <name> # load a specialized skill (transform, data-workflow, dashboard, git-sync, data-app, …)
Command groups, in full: authenticate with named profiles; inspect databases (list, get, full metadata rollup, schemas, tables in a schema) and trigger a manual schema sync or field-values rescan; inspect tables and fields; list/get/create/update/archive cards (questions, models, metrics) and run them as JSON/CSV/XLSX; list/get/create/update dashboards and patch dashcards; list/get/create collections and traverse the hierarchy by id, entity_id, or "root"/"trash" (with items and recursive tree); list/get/create/update/archive native query snippets, segments, and measures; author/update/run transforms and schedule transform-jobs; publish tables to the Library; create data actions; create, bundle and turn off data apps; read/update settings; search content (cards, dashboards, collections, transforms, metrics); git-sync to/from a git remote (status, dirty, import, export, branches, stash, add/remove a collection from sync).
Don't drive Metabase by curling /api/... directly — the CLI handles auth profiles, retries, schema validation, and credential redaction.
Doing a whole job, not one command? Higher-level data-engineering workflows — raw data to clean tables, the semantic layer, dashboards — live in the metabase-rde skill, which drives this CLI:
npx skills add metabase/agent-skills --skill metabase-rde
When it is installed, follow it; it loads the bundled skills it needs.