
Metabase MCP, Metabase's built-in MCP server
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.
Metabase's docs cover it: add your Metabase address, run /mcp, then sign in to Metabase.
Known problems
- Open
On some self-hosted instances it connects after sign-in but shows no tools
Since Sep 2026 · GitHub
Add Metabase from Claude's connector directory and enter your Metabase address, which must be reachable on the internet over HTTPS.
Known problems
- Open
Fails to connect when Metabase sits under a sub-path behind a reverse proxy
Since Aug 2026 · GitHub
- Open
Will not connect to a Metabase that is only reachable on a private network or VPN
Since Jun 2026 · GitHub
- Fixed
Sign-in could fail with a 'headers too large' error on Metabase Cloud
Reported Jun 2026 · GitHub
Metabase has no setup steps for Cursor, but lists it among apps that can show its charts in the chat once an admin turns that on. metabase.com
Metabase has no setup steps for VS Code, but lists it among apps that can show its charts in the chat once an admin turns that on. metabase.com
Supports hosted MCP servers.
Not in Metabase's docs. One user connected it with the server address and Metabase sign-in.
Known problems
- Closed
Sign-in stopped working after a few hours with no way to sign in again
Workaround: Delete and re-add the server in Codex to get the sign-in prompt back.
Reported Jul 2026 · GitHub
Supports hosted MCP servers.
Supports hosted MCP servers.
Metabase has no setup steps for ChatGPT, but lists it for charts in the chat. Your Metabase must be reachable on the internet over HTTPS. metabase.com
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Client does not support this transport.
Install Metabase MCP
Claude Code
- 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
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 ·
searchOpens 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_contentLists 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_collectionLists 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_dataRuns 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_queryRuns 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_questionDraws 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_queryRuns 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_sqlLists 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_valuesLooks 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 ·
glossarySaves 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_writeCreates 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_writeCreates or edits a metric, or moves it to the trash
Saves a reusable metric, a query with one calculation and at most one grouping, or updates or trashes an existing one.
Try: “Create a metric for monthly recurring revenue from the subscriptions table”
Delete ·
metric_writeCreates or edits a saved filter on a table, or trashes it
Saves a named set of filters on a table, such as 'Active customers', so people can reuse it, or updates or trashes one. Each update records a short change note.
Try: “Create a segment called Enterprise accounts for customers with more than 500 seats”
Delete ·
segment_writeCreates or edits a saved calculation on a table, or trashes it
Saves a named calculation on a table, such as total revenue, so people can reuse it, or updates or trashes one. Each update records a short change note.
Try: “Add a measure for average order value on the orders table”
Delete ·
measure_writeWrites or edits a Metabase document, or trashes it
Creates a Metabase document in Markdown with embedded charts, edits its text in place or rewrites it, or moves it to the trash.
Try: “Write a document summarising last month's sales with the revenue chart embedded”
Delete ·
document_writeCreates, renames or moves a collection, or trashes it
Creates a collection or updates one, such as its name, description or parent folder. Trashing moves the collection and everything in it to the trash; there is no hard delete.
Try: “Create a Q4 Planning collection inside Finance”
Delete ·
collection_writeMakes a copy of a question, dashboard or document
Copies a question, dashboard or document into a collection you choose. For a dashboard it can also copy all its questions.
Try: “Duplicate the Sales dashboard into the EMEA collection”
Write ·
duplicate_contentBookmarks an item or removes the bookmark
Adds or removes a bookmark on a collection, dashboard, document, metric, model or question for you.
Try: “Bookmark the Revenue Overview dashboard”
Write ·
bookmark_contentSets up or changes an alert that emails or Slacks a question's results
Creates or updates an alert on a saved question that sends its results by email or to a Slack channel on a schedule, or when a condition is met. Alerts can be paused but not deleted here.
Try: “Alert me on Slack in #data-team whenever daily signups drop below 100”
Write ·
alert_writeSends a dashboard by email or Slack on a schedule
Creates or updates a dashboard subscription that delivers it by email or Slack on a schedule, with optional filter values. Trashing it is the only way to remove it.
Try: “Email the Sales dashboard to the sales team every Monday at 9am”
Delete ·
subscription_writeUsed by the assistant behind the scenes
Reads Metabase's built-in guides on how to use its tools
Lists or opens Metabase's reference topics, such as how to write its query format or chart settings, so the assistant can use the other tools correctly.
Try: “Look up how Metabase chart settings work before saving this chart”
Read ·
learnRedraws a chart after you click into it in the chat
Used when you click into a chart in the chat to drill through. It redraws the chart for that selection; only apps that can show charts in the chat get it.
Try: “Drill into the March bar on that chart”
Read ·
render_drill_through
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | Pro 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 to | Your Metabase instance only; query results go to your AI client, which may forward them to its AI provider |
| Sign-in and keys | OAuth tokens issued by Metabase's built-in OAuth server, stored by your AI client; headless JWT-exchanged tokens last one hour. |
| Scopes |
|
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.
| Server | Official | Runs | Sign-in | Tools | Popularity |
|---|---|---|---|---|---|
| Metabase (built in)This page | Official | Your Metabase | Metabase account | 23 | – |
| Metabase MCP (headless) | Community | Local | – | – | 47.6K/wk |
| jerichosequitin/metabase-mcp | Community | Local | – | – | 88 |
| cognitionai/metabase-mcp-server | Community | Local | – | – | 63 |
| @easecloudio/mcp-metabase-server | Community | Local | – | – | 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
“We use a read only platform called Metabase which reads one of the MySQL replicas.”superjoseGitHub issueJun 2026
“The official Claude Desktop integration for Metabase MCP requires using HTTPS URLs that are reachable by Anthropic servers.”GitHub issueJul 2026
“Metabase MCP OAuth authorization works initially with Codex Desktop, but after some time the MCP client can no longer initialize.”
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
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
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 12Hide
- MCP server | Metabase Documentation · metabase.com
- Metabase connector for Claude · claude.com
- MCP server tools | Metabase Documentation · metabase.com
- Usage controls | Metabase Documentation · metabase.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- GitHub · github.com
- Hacker News · news.ycombinator.com
- Hacker News · news.ycombinator.com
- GitHub · github.com