--- title: "Metabase MCP server for AI agents - actionlake" description: "Give Claude 668 Metabase actions through one MCP server: apps, card, database, transform. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/metabase updated: 2026-10-23 --- Connectors · Observability & analytics # Metabase MCP server for AI agents. actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Metabase and the rest of your systems. It gives your agent 668 Metabase actions (363 reads, 248 writes and 57 that wait for a confirmation) and holds the Metabase credential itself, so the agent never does. It paces Metabase's limits and records every call. [Connect Metabase free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) 100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you. `claude mcp add --transport http actionlake https://connect.actionlake.com/mcp` the first call ``` do { action: "metabase.user.list", intent: "check which Metabase account is connected" } # GET /api/user · read · 1 upstream call ``` - 668 actions in one signed file - 363 read look, never change - 248 write create and update - 57 wait for a yes destructive, confirmed first Set up ## Connect Metabase in three steps. 1. 01 ### Add actionlake to Claude. Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us. `https://connect.actionlake.com/mcp` 2. 02 ### Connect Metabase. API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key. - `api_key` Metabase API key (Admin settings > Authentication > API keys > Create API key) - `host` Where your Metabase lives: your host ``` account { op: "connections.requirements", service: "metabase" } # free: exactly what to paste, and what is found for you ``` 3. 03 ### Make the first call. Check before a write. Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free. ``` do { action: "metabase.user.list" } # get /api/user · read · 1 upstream call check { action: "metabase.user.create", input: { … } } # free: inputs, permissions, cost and confirmations, nothing sent ``` Metabase at a glance **Sign-in** API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. **You provide** `api_key` **Setup fields** `host` **Limits we pace to** 10 calls a second, per connection **API covered** Metabase REST API (unversioned; OpenAPI 3.1 published with the docs), at your Metabase instance's API base URL, which you enter when connecting **Built from** Metabase's documentation, read 23 October 2026[metabase.com](https://www.metabase.com/docs/latest/api.json) [metabase.com](https://www.metabase.com/docs/latest/api) **Service file** Version 1.0.0, signed (Ed25519) **Cached reads** 312 of 363 reads, for up to 5 minutes; a write clears what it affects **Shared entities** 6, so ask can line Metabase up with your other systems **Data** Processed and stored in Sydney, Australia. No US region yet Capabilities ## What an AI agent can do in Metabase. 668 actions in 424 areas. Every one carries its effect, so a key can allow the reads and hold the rest. - **363** read look, never change - **248** write create and update - **57** destructive wait for a confirmation 1. ### Apps 9 5 read · 3 write · 1 destructive POST /api/apps/{slug}/draft · GET /api/apps · POST /api/apps/{slug}/query · POST /api/apps/{slug}/query-table-dependencies 2. ### Card 9 4 read · 4 write · 1 destructive GET /api/card · POST /api/card · GET /api/card/{id} · PUT /api/card/{id} 3. ### Database 9 2 read · 6 write · 1 destructive GET /api/database · POST /api/database · GET /api/database/{id} · PUT /api/database/{id} 4. ### Transform 9 2 read · 6 write · 1 destructive POST /api/transform/{id}/cancel · POST /api/transform · GET /api/transform · POST /api/transform/{id}/reset-checkpoint 5. ### Dashboard 8 2 read · 5 write · 1 destructive GET /api/dashboard · POST /api/dashboard · GET /api/dashboard/{id} · PUT /api/dashboard/{id} 6. ### User 8 2 read · 5 write · 1 destructive GET /api/user · POST /api/user · GET /api/user/{id} · PUT /api/user/{id} 7. ### Action 7 2 read · 4 write · 1 destructive POST /api/action · POST /api/action/{id}/execute · GET /api/action · POST /api/action/{id}/public_link 8. ### Document 7 2 read · 4 write · 1 destructive POST /api/document · GET /api/document · GET /api/document/{document-id} · PUT /api/document/{document-id} **112 more areas · 602 actions** - Collection **6** - Embed theme **6** - Field **6** - Notification **6** - Table **6** - Transform job **6** - API key **5** - Comment **5** - Ee custom viz plugin **5** - Ee scim V2 groups **5** - Ee scim V2 users **5** - MT gtap **5** - Permissions group **5** - Permissions membership **5** - Segment **5** - Timeline **5** - Channel **4** - Ee tenant **4** - Glossary **4** - Index request **4** - LLM providers **4** - Measure **4** - Metabot conversations **4** - Model index **4** - Native query snippet **4** - Osi AI context **4** - Persist card **4** - Pulse **4** - Timeline event **4** - Transform tag **4** - Agent V1 question **3** - Bookmark **3** - Cache **3** - Ee AI controls usage group **3** - Ee AI controls usage tenant **3** - Ee database replication connection **3** - Ee gsheets connection **3** - Ee replacement runs **3** - Ee support access grant **3** - Ee transforms inspect **3** - Metabot metabot **3** - Setting **3** - User key value namespace key **3** - Activity recents **2** - Agent V1 dashboard **2** - Agent V1 metric **2** - Alert **2** - Cloud migration **2** - Collection graph **2** - Dashboard dashcard card **2** - Database datasets **2** - Database schema **2** - Database schemas **2** - Dataset **2** - Ee advanced permissions application graph **2** - Ee advanced permissions impersonation **2** - Ee AI controls permissions **2** - Ee AI controls permissions advanced **2** - Ee AI controls usage instance **2** - Ee cloud add ons **2** - Ee content translation dictionary **2** - Ee email override **2** - Ee library **2** - Ee metabot analytics conversations **2** - Ee scim API key **2** - Ee security center **2** - Ee transforms python library **2** - Ee upload management tables **2** - Email **2** - Embed card query **2** - Geojson **2** - Logger adjustment **2** - Metabot metabot prompt suggestions **2** - Metric **2** - Metric dimension **2** - Notification admin **2** - Notify DB **2** - Permissions graph **2** - Persist **2** - Persist database **2** - Public action **2** - Public card query **2** - Public dashboard dashcard card **2** - Public document card **2** - Revision **2** - Search weights **2** - Session **2** - Task **2** - Task runs **2** - Transform job runs **2** - Transform run **2** - Action execute values **1** - Action public **1** - Action public link **1** - Activity most recently viewed dashboard **1** - Activity popular items **1** - Activity recent views **1** - Agent V1 collection **1** - Agent V1 construct native query **1** - Agent V1 execute **1** - Agent V1 execute SQL **1** - Agent V1 ping **1** - Agent V1 read resource **1** - Agent V1 search **1** - Agent V2 construct query **1** - Agent V2 query **1** - Alert subscription **1** - Analytics anonymous stats **1** - Analytics internal **1** - Analytics proxy **1** - API key count **1** - 305 smaller areas **305** Top actions ## The Metabase API, shaped for agents. The ids your agent types, what each does, and the one name it shares with other systems. 62 of Metabase's 63 action names are shared with at least one other connector, so an agent learns them once. | Action | What it does | Effect | Same name in | | --- | --- | --- | --- | | `metabase.user.list` GET /api/user | Fetch a list of `Users` for admins or group managers. By default returns only active users for admins/data-analysts and only active users within groups that… | read | `identity.user.list` 474 connectors | | `metabase.permissions_group.list` GET /api/permissions/group | Fetch all `PermissionsGroups`, including a count of the number of `:members` in that group. This API requires superuser or group manager of more than one… | read | `identity.group.list` 262 connectors | | `metabase.me.get` GET /api/user/current | Fetch the current `User`. | read | `identity.current_user.get` 307 connectors | | `metabase.user.create` POST /api/user | Create a new `User`, return a 400 if the email address is already taken. | write | `identity.user.create` 262 connectors | | `metabase.permissions_group.create` POST /api/permissions/group | Create a new `PermissionsGroup`. | write | `identity.group.create` 205 connectors | | `metabase.user.delete` DELETE /api/user/{id} | Disable a `User`. This does not remove the `User` from the DB, but instead disables their account. | destructive | `identity.user.delete` 253 connectors | | `metabase.collection.list` GET /api/collection | Fetch a list of all Collections that the current user has read permissions for (`:can_write` is returned as an additional property of each Collection so you… | read | `content.folder.list` 62 connectors | | `metabase.permissions_membership.list` GET /api/permissions/membership | Fetch a map describing the group memberships of various users. This map's format is:. | read | `identity.group_member.list` 103 connectors | | `metabase.table.list` GET /api/table | Get all `Tables`. | read | `content.table.list` 21 connectors | | `metabase.database.list` GET /api/database | Fetch all `Databases`. | read | `content.database.list` 12 connectors | | `metabase.collection.create` POST /api/collection | Create a new Collection. | write | `content.folder.create` 62 connectors | | `metabase.api_key.create` POST /api/api-key | Create a new API key (and an associated `User`) with the provided name and group ID. | write | `identity.service_account.create` 32 connectors | Try it ## Prompts to paste into Claude. Each one names the Metabase actions it will call, so you know what it reads and what it changes before you send it. 1. Read read Who has access in Metabase? List every user and their role. calls `metabase.user.list` 2. Write write POST /api/user in Metabase. Show me exactly what you will send before you save it. calls `metabase.user.create` Governance for Metabase ## Destructive actions wait for a yes. 57 Metabase actions are destructive. The first 10: - DELETE /api/user/{id} `metabase.user.delete` - DELETE /api/permissions/group/{group-id} `metabase.permissions_group.delete` - DELETE /api/permissions/membership/{id} `metabase.permissions_membership.delete` - DELETE /api/collection/{id} `metabase.collection.delete` - DELETE /api/api-key/{id} `metabase.api_key.delete` - DELETE /api/database/{id} `metabase.database.delete` - DELETE /api/dashboard/{id} `metabase.dashboard.delete` - DELETE /api/card/{id} `metabase.card.delete` - DELETE /api/segment/{id} `metabase.segment.delete` - DELETE /api/document/{document-id} `metabase.document.delete` A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after. do metabase.user.delete confirm_policy: **human** DELETE /api/user/{id}? **intent:** the user asked me to dELETE /api/user/{id} run suspended · waiting for a named person · key _metabase-agent_ cannot confirm itself In the console, or from an emailed signed link. a key for this connector ``` account { op: "keys.create", name: "metabase-agent", allowed_actions: ["metabase.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "metabase.user.delete", approver: "lead@example.com" }, { match: "metabase.permissions_group.delete", approver: "lead@example.com" }, { match: "metabase.permissions_membership.delete", approver: "lead@example.com" } ] } ``` Illustrative. Scoped to Metabase only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person. Cost ## What Metabase costs on actionlake. Every Metabase action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Metabase refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. - 1 upstream call per action all 668 Metabase actions - 668 actions page each page of a long list is one call - 312 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every Metabase action. 668 actions by area: the id your agent calls, what it does, and its effect. **Apps 9** - `metabase.apps.draft` POST /api/apps/{slug}/draft write - `metabase.apps.list` GET /api/apps read - and 7 more in this area **Card 9** - `metabase.card.create` POST /api/card write - `metabase.card.get` GET /api/card/{id} read - and 7 more in this area **Database 9** - `metabase.database.create` POST /api/database write - `metabase.database.get` GET /api/database/{id} read - and 7 more in this area **Transform 9** - `metabase.transform.cancel` POST /api/transform/{id}/cancel write - `metabase.transform.create` POST /api/transform write - and 7 more in this area **Dashboard 8** - `metabase.dashboard.create` POST /api/dashboard write - `metabase.dashboard.get` GET /api/dashboard/{id} read - and 6 more in this area **User 8** - `metabase.user.create` POST /api/user write - `metabase.user.get` GET /api/user/{id} read - and 6 more in this area **Action 7** - `metabase.action.create` POST /api/action write - `metabase.action.execute` POST /api/action/{id}/execute write - and 5 more in this area **Document 7** - `metabase.document.create` POST /api/document write - `metabase.document.get` GET /api/document/{document-id} read - and 5 more in this area **Collection 6** - `metabase.collection.create` POST /api/collection write - `metabase.collection.get` GET /api/collection/{id} read - and 4 more in this area **Embed theme 6** - `metabase.embed_theme.copy` POST /api/embed-theme/{id}/copy write - `metabase.embed_theme.create` POST /api/embed-theme write - and 4 more in this area **Field 6** - `metabase.field.dimension` POST /api/field/{id}/dimension write - `metabase.field.discard_values` POST /api/field/{id}/discard_values write - and 4 more in this area **Notification 6** - `metabase.notification.create` POST /api/notification write - `metabase.notification.list` GET /api/notification read - and 4 more in this area **Table 6** - `metabase.table.discard_values` POST /api/table/{id}/discard_values write - `metabase.table.get` GET /api/table/{id} read - and 4 more in this area **Transform job 6** - `metabase.transform_job.create` POST /api/transform-job write - `metabase.transform_job.get` GET /api/transform-job/{job-id} read - and 4 more in this area **API key 5** - `metabase.api_key.create` POST /api/api-key write - `metabase.api_key.delete` DELETE /api/api-key/{id} destructive - and 3 more in this area **Comment 5** - `metabase.comment.create` POST /api/comment write - `metabase.comment.list` GET /api/comment read - and 3 more in this area **Ee custom viz plugin 5** - `metabase.ee_custom_viz_plugin.dev_url` PUT /api/ee/custom-viz-plugin/{id}/dev-url write - `metabase.ee_custom_viz_plugin.list` GET /api/ee/custom-viz-plugin read - and 3 more in this area **Ee scim V2 groups 5** - `metabase.ee_scim_v2_groups.create` POST /api/ee/scim/v2/Groups write - `metabase.ee_scim_v2_groups.get` GET /api/ee/scim/v2/Groups/{id} read - and 3 more in this area **Ee scim V2 users 5** - `metabase.ee_scim_v2_users.create` POST /api/ee/scim/v2/Users write - `metabase.ee_scim_v2_users.get` GET /api/ee/scim/v2/Users/{id} read - and 3 more in this area **MT gtap 5** - `metabase.mt_gtap.create` POST /api/mt/gtap write - `metabase.mt_gtap.get` GET /api/mt/gtap/{id} read - and 3 more in this area **Permissions group 5** - `metabase.permissions_group.create` POST /api/permissions/group write - `metabase.permissions_group.get` GET /api/permissions/group/{id} read - and 3 more in this area **Permissions membership 5** - `metabase.permissions_membership.create` POST /api/permissions/membership write - `metabase.permissions_membership.delete` DELETE /api/permissions/membership/{id} destructive - and 3 more in this area **Segment 5** - `metabase.segment.create` POST /api/segment write - `metabase.segment.get` GET /api/segment/{id} read - and 3 more in this area **Timeline 5** - `metabase.timeline.create` POST /api/timeline write - `metabase.timeline.get` GET /api/timeline/{id} read - and 3 more in this area **Channel 4** - `metabase.channel.create` POST /api/channel write - `metabase.channel.get` GET /api/channel/{id} read - and 2 more in this area **Ee tenant 4** - `metabase.ee_tenant.create` POST /api/ee/tenant write - `metabase.ee_tenant.get` GET /api/ee/tenant/{id} read - and 2 more in this area **Glossary 4** - `metabase.glossary.create` POST /api/glossary write - `metabase.glossary.delete` DELETE /api/glossary/{id} destructive - and 2 more in this area **Index request 4** - `metabase.index_request.create` POST /api/index/request write - `metabase.index_request.delete` DELETE /api/index/request/{id} destructive - and 2 more in this area **LLM providers 4** - `metabase.llm_providers.create` POST /api/llm/providers write - `metabase.llm_providers.delete` DELETE /api/llm/providers/{key} destructive - and 2 more in this area **Measure 4** - `metabase.measure.create` POST /api/measure write - `metabase.measure.get` GET /api/measure/{id} read - and 2 more in this area Metabot conversations **4** Model index **4** Native query snippet **4** Osi AI context **4** Persist card **4** Pulse **4** Timeline event **4** Transform tag **4** Agent V1 question **3** Bookmark **3** Cache **3** Ee AI controls usage group **3** Ee AI controls usage tenant **3** Ee database replication connection **3** Ee gsheets connection **3** Ee replacement runs **3** Ee support access grant **3** Ee transforms inspect **3** Metabot metabot **3** Setting **3** User key value namespace key **3** Activity recents **2** Agent V1 dashboard **2** Agent V1 metric **2** Alert **2** Cloud migration **2** Collection graph **2** Dashboard dashcard card **2** Database datasets **2** Database schema **2** Database schemas **2** Dataset **2** Ee advanced permissions application graph **2** Ee advanced permissions impersonation **2** Ee AI controls permissions **2** Ee AI controls permissions advanced **2** Ee AI controls usage instance **2** Ee cloud add ons **2** Ee content translation dictionary **2** Ee email override **2** Ee library **2** Ee metabot analytics conversations **2** Ee scim API key **2** Ee security center **2** Ee transforms python library **2** Ee upload management tables **2** Email **2** Embed card query **2** Geojson **2** Logger adjustment **2** Metabot metabot prompt suggestions **2** Metric **2** Metric dimension **2** Notification admin **2** Notify DB **2** Permissions graph **2** Persist **2** Persist database **2** Public action **2** Public card query **2** Public dashboard dashcard card **2** Public document card **2** Revision **2** Search weights **2** Session **2** Task **2** Task runs **2** Transform job runs **2** Transform run **2** Action execute values **1** Action public **1** Action public link **1** Activity most recently viewed dashboard **1** Activity popular items **1** Activity recent views **1** Agent V1 collection **1** Agent V1 construct native query **1** Agent V1 execute **1** Agent V1 execute SQL **1** Agent V1 ping **1** Agent V1 read resource **1** Agent V1 search **1** Agent V2 construct query **1** Agent V2 query **1** Alert subscription **1** Analytics anonymous stats **1** Analytics internal **1** Analytics proxy **1** API key count **1** 305 smaller areas **305** This index shows a sample of each area. All 668 actions, with their inputs and prices, are in the [catalogue](https://actionlake.com/console/catalogue), which a free sandbox key can search. Questions ## The Metabase MCP server, answered. **Is there a Metabase MCP server for Claude?** Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 668 Metabase actions across apps, card, database and transform, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Metabase. **What do I need to connect Metabase?** Metabase API key (Admin settings > Authentication > API keys > Create API key). Plus your host. The free call account { op: "connections.requirements", service: "metabase" } lists exactly what to paste. **Can an AI agent delete or change things in Metabase?** Only if its key allows it, and only with an explicit confirmation. 57 Metabase actions are destructive, including DELETE /api/user/{id}, DELETE /api/permissions/group/{group-id} and DELETE /api/permissions/membership/{id}. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it. **Will an AI agent use up my Metabase API limit?** actionlake paces every call to the limits in the Metabase service file: 10 calls a second per connection. Repeated reads are answered from cache (312 Metabase actions can be), which never reaches Metabase. **What does a Metabase action cost?** One upstream call, the only unit actionlake bills. A list that pages bills one call per page (668 Metabase actions page). Cache hits, searches, dry runs and calls Metabase refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. **Which Metabase API does it cover?** The Metabase REST API (unversioned; OpenAPI 3.1 published with the docs) at your Metabase instance's API base URL, which you enter when connecting. It is built from Metabase's documentation as read on 23 October 2026. 668 actions in 424 areas, each one in the signed service file (version 1.0.0). **Does actionlake keep my Metabase data, and where?** actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Metabase credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models. **Which AI clients can use it?** Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names. ## More connectors like Metabase Shares the most action names with - [Preset 23](https://actionlake.com/connectors/preset) - [Lightdash 18](https://actionlake.com/connectors/lightdash) - [Sigma Computing 16](https://actionlake.com/connectors/sigma-computing) - [Sentry 16](https://actionlake.com/connectors/sentry) - [Looker 15](https://actionlake.com/connectors/looker) - [Databricks 14](https://actionlake.com/connectors/databricks) Joins with, on shared entities - [Appwrite Cloud 4](https://actionlake.com/connectors/appwrite-cloud) - [Filevine 4](https://actionlake.com/connectors/filevine) - [Bynder 4](https://actionlake.com/connectors/bynder) - [Zoho WorkDrive 4](https://actionlake.com/connectors/zoho-workdrive) - [iManage Work 4](https://actionlake.com/connectors/imanage-work) - [Airtable 4](https://actionlake.com/connectors/airtable) Browse - [All Observability & analytics connectors](https://actionlake.com/connectors/category/observability-and-analytics) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by Metabase; the name is the vendor's own. Counts are from the Metabase service file, version 1.0.0. ## Give your agent Metabase today. [Connect Metabase free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/metabase More: https://actionlake.com/llms.txt