PlugWiki
Metabase logo

Metabase MCP, Metabase's built-in MCP server

Official · by MetabaseRemote

Lets Claude, ChatGPT or Cursor search, query and chart the data in your Metabase. You sign in with your Metabase account, nothing to install.

This is Metabase's own connection for AI assistants, built into Metabase itself. Once an admin turns it on, you can ask Claude, ChatGPT or Cursor to search your dashboards, run questions on your data, draw charts and save new questions or dashboards. It only sees what your Metabase account can see, but by default it can also run raw SQL and send scheduled emails or Slack messages, so ask your admin which tools your group gets.

Good for

  • Teams that already use Metabase and want answers from their data inside Claude or ChatGPT
  • Analysts who want an assistant to write queries, charts and dashboards against real tables
  • Developers who build Metabase content as code with Claude Code or Cursor
  • Admins on Pro or Enterprise who want to limit which tools each group can use
  • Product teams embedding Metabase that want an in-app agent to query on a user's behalf

Works in

2 with issues · 11 should work

Tap an app to see how to set it up and any known problems.

Install Metabase MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Metabase MCP server to Claude Code. Run this command:
    
    claude mcp add --scope user --transport http metabase https://<your-metabase>/api/metabase-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires A Metabase admin has turned on the MCP server, Sign-in with your Metabase account.

Read-only mode: Ask your Metabase admin to allow only the read and query tools for your group (Pro and Enterprise plans).

Replace <your-metabase> with your Metabase address. Then start claude, run /mcp, pick Metabase and choose Authenticate (you may need to Enable it first). Claude Code does not show inline charts, so the chart tool is missing there by design. For a Metabase in Docker, set MB_SITE_URL to the address you connect to, or sign-in fails.

From the vendor's docs. Source.

Tools

  • Finds questions, dashboards, metrics, tables and other content by keyword or meaning

    Searches your Metabase content by keyword, or by meaning when semantic search is on. It can narrow to certain types, one collection, things you created, the trash, or your recently viewed items.

    Try: “Find our dashboards about customer churn”

    Read · search

  • Opens a question, dashboard, metric or document and reads its details

    Reads up to 10 items at once, such as a dashboard and its questions, with optional extras like the stored query, columns, chart settings, filters, layout or document comments.

    Try: “What does the Revenue Overview dashboard show, and what filters does it have?”

    Read · get_content

  • Lists what is in a collection or shows the folder tree

    Lists the items in a collection, including your personal collection or the trash, or shows the nested folder structure. Results can be sorted, filtered by type, or limited to things you created.

    Try: “What's in the Marketing collection?”

    Read · browse_collection

  • Lists your databases, schemas, tables, models and columns

    Walks your connected data from databases to schemas, tables and fields, or lists the models built on a database. Sensitive fields are always left out, and values only show for tables you can query.

    Try: “Which tables in the warehouse have order data, and what columns do they have?”

    Read · browse_data

  • Runs a query on your data and returns the results

    Runs a structured Metabase query (counts, sums, grouping, filters, joins) and returns up to 2,000 rows per page. It can also check a query without running it.

    Try: “How many orders did we get each month this year?”

    Read · execute_query

  • Runs a saved question, with filter values if you want

    Runs a question already saved in Metabase and returns its results, applying any filter values you give it.

    Try: “Run the Weekly Active Users question for the EU region”

    Read · run_saved_question

  • Draws a chart of query results right in the chat

    Shows the results of a query as an interactive chart inside your AI app, with an option to open it in Metabase. Only apps that can show charts in the chat get this tool.

    Try: “Show me weekly signups for the last quarter as a line chart”

    Read · visualize_query

  • Runs your own SQL directly on a connected database

    Runs raw SQL exactly as written on a database where you have native query permission. Metabase marks it as able to change or delete data, so what it can do depends on your database login.

    Try: “Write SQL that shows the 7-day rolling average of revenue and run it”

    Delete · execute_sql

  • Lists the choices available in a dashboard or question filter

    Returns the values a filter can take, such as every country in a Country filter, optionally narrowed by search text or by the other filters already chosen.

    Try: “Which regions can I pick in the Sales dashboard's Region filter?”

    Read · get_parameter_values

  • Looks up what your company's data terms mean

    Lists the terms in your Metabase glossary with their definitions, or looks up one term.

    Try: “What does 'active customer' mean in our glossary?”

    Read · glossary

  • Saves a new question or model, or edits or trashes one

    Creates or updates a saved question or model, including its chart type and settings, in a collection or dashboard. Setting it as archived moves it to the trash, where it can be restored.

    Try: “Save that monthly orders query as a bar chart in my collection”

    Delete · question_write

  • Creates or edits a dashboard, or moves it to the trash

    Creates a dashboard or changes one, such as its name, layout, cards and filters, and can preview the layout without saving. Trashing is the only way it removes a dashboard.

    Try: “Make a dashboard with our monthly revenue, orders and churn questions”

    Delete · dashboard_write

From the official docs

Pros and cons

Good

  • Built into Metabase and maintained by Metabase, so there is nothing extra to install or host.
  • You sign in with your Metabase account and it only sees what you can see.
  • It draws charts right in the chat in Claude, ChatGPT, Cursor and VS Code.
  • It can save the questions, dashboards and metrics it builds back into Metabase.
  • It does not use your Metabase AI connection, since your AI app brings the model.
  • Admins get a log of every app that connected and who approved it.

Watch out

  • An admin has to turn it on before anyone can connect.
  • Raw SQL and scheduled email or Slack delivery are on for everyone by default.
  • Limiting tools per group, usage analytics and headless access need Pro or Enterprise.
  • Claude's connector needs a Metabase address reachable on the internet over HTTPS.
  • Self-hosted setups behind proxies or sub-paths can break the sign-in.

Permissions

medium risk · 6 things to watch

Medium risk

Your assistant can read anything you can see in Metabase, run raw SQL on your databases and send your data by email or Slack on a schedule. Ask your admin to give your group only the read and query tools unless you need more.

What it can do

Watch out for

  • It can run raw SQL on your databases

    It runs SQL exactly as written on any database where you can write native queries. Ask your admin to block the Raw SQL tools for groups that do not need them. metabase.com

  • It can email or Slack your data on a schedule

    It can create alerts and dashboard subscriptions sent to addresses or channels it picks. Check each one before you approve it, or have the Deliveries tools blocked. metabase.com

  • Every tool is on for everyone by default

    Until an admin limits tools per group, any user can use the write, SQL and delivery tools within their own Metabase permissions. Limiting tools needs Pro or Enterprise. metabase.com

  • Deleted content goes to the trash

    Dashboards, questions, collections and similar content can only be moved to the trash, so you can restore them. metabase.com

  • Your results reach your AI provider

    Query results go to your AI app, which may send them to its AI provider. Check your AI app's data settings before connecting sensitive databases. metabase.com

  • Admins can see who connected

    Admin > AI > MCP > Authorizations logs every app that registered and every sign-in people approved or denied. metabase.com

Security advisories

No published security advisories for the MCP server as of Nov 1, 2026.

45 other advisories are about the wider metabase project, not this MCP server. See them on GitHub

Technical details
Turning on read-onlyPro and Enterprise: Admin > AI > Usage controls > MCP tools access, allow only the Read and Query rows for a group. Headless JWT tokens can request fewer scopes, for example agent:content:read agent:query:run.
Talks toYour Metabase instance only; query results go to your AI client, which may forward them to its AI provider
Sign-in and keysOAuth tokens issued by Metabase's built-in OAuth server, stored by your AI client; headless JWT-exchanged tokens last one hour.
Scopes
  • agent:content:read: see your Metabase content and data structure

  • agent:content:write: create, edit and trash Metabase content

  • agent:query:run: run queries on connected databases and see results

  • agent:sql:run: write and run raw SQL on connected databases

  • agent:delivery:write: create alerts and subscriptions that email or Slack your data

Alternatives

Use Metabase's built-in server if your Metabase is reachable over HTTPS and an admin can turn it on. Pick a community server you run yourself only when Claude cannot reach your Metabase, such as on a private network.

ServerOfficialRunsSign-inToolsPopularity
Metabase (built in)This pageOfficialYour MetabaseMetabase account23–
Metabase MCP (headless)CommunityLocal––47.6K/wk
jerichosequitin/metabase-mcpCommunityLocal––88
cognitionai/metabase-mcp-serverCommunityLocal––63
@easecloudio/mcp-metabase-serverCommunityLocal––1K/wk

What people say

People like having real Metabase data inside their coding assistant and get stuck mostly on connecting self-hosted instances.

What people like

  • Lets an assistant check code against real production data through a read-only Metabase

Common complaints

  • Claude's connector needs a public HTTPS address, which blocks instances behind a VPN
  • Proxies, Cloudflare and sub-paths can break sign-in or the server address
  • Some users had to re-add the server in Codex after sign-in stopped working
  • Some developers prefer a command-line tool over an MCP server for Metabase

In their words

Questions

What is the Metabase MCP server URL?

https://<your-metabase>/api/metabase-mcp, with your own Metabase address in front. Admins can copy it from Admin > AI > MCP > Settings.

Is the Metabase MCP server free?

It comes with Metabase, and you do not need an AI provider set up in Metabase, because your AI app brings the model. Limiting tools per group, usage analytics and sign-in without a browser need Pro or Enterprise.

Is it safe to connect Metabase to my AI assistant?

It only sees what your Metabase account can see. By default it can also run raw SQL and send data by email or Slack, so ask your admin to allow only the tools your group needs.

Can it be read-only?

Yes, on Pro and Enterprise. An admin can allow only the read and query tools for a group, and blocked tools disappear from your AI app's list.

Can it delete my dashboards or data?

It can move dashboards, questions and collections to the trash, where you can restore them. Raw SQL runs exactly as written, so it can change data wherever your database login allows it.

Why can't I connect from Claude Desktop?

Claude's connector needs your Metabase to be reachable on the internet over HTTPS, and it cannot reach localhost. Use Claude Code for a local or private Metabase, and check that your Site URL matches the address you connect to.

Why does it ask me to sign in again?

Apps you connected before Metabase 0.64 have to sign in once more after you upgrade.

Why don't I see charts in Claude Code?

Claude Code cannot show charts in the chat, so Metabase leaves the chart tool out there. Charts work in Claude on the web and Desktop, ChatGPT, Cursor and VS Code once an admin turns them on.

Does it use my Metabot or AI credits?

No. Calls from your AI app do not count against Metabase's own AI connection.

Official Metabase server or a community one?

Use the built-in one when your Metabase is reachable and an admin can turn it on. Community servers run on your computer with your own Metabase login, which helps when your Metabase sits on a private network.

Examples

  • Get a chart of a metric right in the chat

    Show me weekly signups for the last quarter as a line chart

  • Check code against production data through a read-only Metabase on a database replica

    Source
  • Have a coding assistant write Metabase questions and dashboards as files that point at real columns

    Source

Information

updated Nov 2, 2026

Publisher
Metabase (official)
Transport
Streamable HTTP
Auth
OAuth
Version
0.1.0
Last commit
Oct 31, 2026
Open issues
3,953
Listed in
Official MCP registry

WebsiteDocsGitHubOfficial MCP RegistryChangelogIssues

Other Metabase MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 12
  1. MCP server | Metabase Documentation · metabase.com
  2. Metabase connector for Claude · claude.com
  3. MCP server tools | Metabase Documentation · metabase.com
  4. Usage controls | Metabase Documentation · metabase.com
  5. GitHub · github.com
  6. GitHub · github.com
  7. GitHub · github.com
  8. GitHub · github.com
  9. GitHub · github.com
  10. Hacker News · news.ycombinator.com
  11. Hacker News · news.ycombinator.com
  12. GitHub · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.