Metabase MCP (headless) MCP Server
Headless Metabase MCP: API-key auth, no OAuth. 178 tools, toolsets, stdio or HTTP, all tiers.
Metabase MCP (headless) scores 50 (Fair), licensed MIT and written in TypeScript. It installs as a local process. It does not declare tools yet. Filed under Data and analytics, Security. GitHub shows 0 stars. Package registries report about 42,960 downloads a week. Install configs are generated for 10 clients. Being listed in the registry is not the same as being vendor-official.
Fair trust
50 of 100 from six public signals. Nobody can buy a point.
- OSI-style license: mit.
License, quality and maintenance
Where the 50 comes from
0 + 20 + 7 + 10 + 10 + 3 = 50. Each factor is capped, so no single signal can carry a listing.
Active in the official MCP registry, plus a known vendor namespace.
Registry: 0 of 30 points.How recently the repository saw a commit or release.
Maintenance: 20 of 20 points.GitHub stars and weekly downloads, on a log scale.
Popularity: 7 of 20 points.A clear, OSI-style open-source license.
License: 10 of 10 points.Not archived, a secure install path, a pinned version.
Security: 10 of 10 points.A real summary, a README with depth, listed tools.
Docs: 3 of 10 points.Install
Pick your client, copy the config, paste it in.
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
{ "mcpServers": { "serdnaley-metabase-mcp": { "command": "npx", "args": [ "-y", "@serdnaley/metabase-mcp@0.5.0" ], "env": { "METABASE_URL": "", "METABASE_API_KEY": "YOUR_METABASE_API_KEY", "METABASE_EMAIL": "", "METABASE_PASSWORD": "YOUR_METABASE_PASSWORD", "METABASE_READ_ONLY_MODE": "", "METABASE_TOOLSETS": "", "METABASE_TOOLS_ENABLE": "", "METABASE_TOOLS_DISABLE": "", "METABASE_CUSTOM_HEADERS": "YOUR_METABASE_CUSTOM_HEADERS" } } }}
Environment variables
| Name | Required | Notes |
|---|---|---|
METABASE_URL | Required | Metabase base URL, e.g. https://metabase.example.com |
METABASE_API_KEYSecret | Optional | Metabase API key (or set METABASE_EMAIL + METABASE_PASSWORD) |
METABASE_EMAIL | Optional | Login email (alternative to an API key) |
METABASE_PASSWORDSecret | Optional | Login password (alternative to an API key) |
METABASE_READ_ONLY_MODE | Optional | true hides all write tools |
METABASE_TOOLSETS | Optional | Comma list of toolsets or presets (all, query, content, admin) |
METABASE_TOOLS_ENABLE | Optional | Extra tools to enable (names or globs) |
METABASE_TOOLS_DISABLE | Optional | Tools to disable (names or globs); always wins |
METABASE_CUSTOM_HEADERSSecret | Optional | Extra headers for every Metabase request (e.g. Cloudflare Access) |
Tools
All capabilitiesTools show up when the registry metadata or the repository README lists them. Public READMEs are read directly. A GitHub token is used only when one is already configured.
About
Headless MCP server for Metabase: API-key auth (no OAuth), stdio or HTTP, 178 tools with toolsets, works on every Metabase tier
Frequently asked questions
What is Metabase MCP (headless) MCP Server?
Headless Metabase MCP: API-key auth, no OAuth. 178 tools, toolsets, stdio or HTTP, all tiers.
How do I install Metabase MCP (headless) MCP Server in Claude Desktop, Cursor, or VS Code?
Pick your client in the Install section on this page and copy the generated config into the client's config file. Step-by-step guides: Claude Desktop, Cursor, and VS Code. Metabase MCP (headless) MCP Server runs locally from the npm package @serdnaley/metabase-mcp with the command npx -y @serdnaley/metabase-mcp@0.5.0.
Is Metabase MCP (headless) MCP Server free and open source?
Yes. Metabase MCP (headless) MCP Server is released under the MIT license, an OSI-approved open-source license, so you can use, modify, and self-host it under those terms.
Does Metabase MCP (headless) MCP Server support remote (HTTP) connections?
No remote endpoint is listed for Metabase MCP (headless) MCP Server. It runs locally on your machine over stdio, started by your MCP client.
How is Metabase MCP (headless) MCP Server's trust score calculated?
Metabase MCP (headless) MCP Server scores 50 out of 100 (Fair). The score adds six capped public signals: registry status, maintenance, popularity, license, documentation, and security. Nobody can pay for points. Read the methodology for the full formula.
Reviews
No reviews yet—Be the first to review
No published reviews yet. Used it? Tell the next person how it went.
Sign inA verified email is required to review this server.
Add badge to your README
Paste either snippet into the repository README. The image links to this listing.