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 See 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

668actionsin one signed file
363readlook, never change
248writecreate and update
57wait for a yesdestructive, confirmed first

Set up

Connect Metabase in three steps.

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
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_keyMetabase API key (Admin settings > Authentication > API keys > Create API key)
- hostWhere your Metabase lives: your host
```
account { op: "connections.requirements", service: "metabase" }
# free: exactly what to paste, and what is found for you
```

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 callcheck { 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 2026metabase.com metabase.com
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.

363readlook, never change
248writecreate and update
57destructivewait for a confirmation

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
Card
9
4 read · 4 write · 1 destructive
GET /api/card · POST /api/card · GET /api/card/{id} · PUT /api/card/{id}
Database
9
2 read · 6 write · 1 destructive
GET /api/database · POST /api/database · GET /api/database/{id} · PUT /api/database/{id}
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
Dashboard
8
2 read · 5 write · 1 destructive
GET /api/dashboard · POST /api/dashboard · GET /api/dashboard/{id} · PUT /api/dashboard/{id}
User
8
2 read · 5 write · 1 destructive
GET /api/user · POST /api/user · GET /api/user/{id} · PUT /api/user/{id}
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
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.

Readread
Who has access in Metabase? List every user and their role.
callsmetabase.user.list
Writewrite
POST /api/user in Metabase. Show me exactly what you will send before you save it.
callsmetabase.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.

dometabase.user.deleteconfirm_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: "[email protected]" },    { match: "metabase.permissions_group.delete", approver: "[email protected]" },    { match: "metabase.permissions_membership.delete", approver: "[email protected]" }  ]}

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.

1upstream call per actionall 668 Metabase actions
668actions pageeach page of a long list is one call
312reads can be cacheda cache hit costs nothing
100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Metabase action.

668 actions by area: the id your agent calls, what it does, and its effect.

Apps9

metabase.apps.draftPOST /api/apps/{slug}/draftwrite
metabase.apps.listGET /api/appsread
and 7 more in this area

Card9

metabase.card.createPOST /api/cardwrite
metabase.card.getGET /api/card/{id}read
and 7 more in this area

Database9

metabase.database.createPOST /api/databasewrite
metabase.database.getGET /api/database/{id}read
and 7 more in this area

Transform9

metabase.transform.cancelPOST /api/transform/{id}/cancelwrite
metabase.transform.createPOST /api/transformwrite
and 7 more in this area

Dashboard8

metabase.dashboard.createPOST /api/dashboardwrite
metabase.dashboard.getGET /api/dashboard/{id}read
and 6 more in this area

User8

metabase.user.createPOST /api/userwrite
metabase.user.getGET /api/user/{id}read
and 6 more in this area

Action7

metabase.action.createPOST /api/actionwrite
metabase.action.executePOST /api/action/{id}/executewrite
and 5 more in this area

Document7

metabase.document.createPOST /api/documentwrite
metabase.document.getGET /api/document/{document-id}read
and 5 more in this area

Collection6

metabase.collection.createPOST /api/collectionwrite
metabase.collection.getGET /api/collection/{id}read
and 4 more in this area

Embed theme6

metabase.embed_theme.copyPOST /api/embed-theme/{id}/copywrite
metabase.embed_theme.createPOST /api/embed-themewrite
and 4 more in this area

Field6

metabase.field.dimensionPOST /api/field/{id}/dimensionwrite
metabase.field.discard_valuesPOST /api/field/{id}/discard_valueswrite
and 4 more in this area

Notification6

metabase.notification.createPOST /api/notificationwrite
metabase.notification.listGET /api/notificationread
and 4 more in this area

Table6

metabase.table.discard_valuesPOST /api/table/{id}/discard_valueswrite
metabase.table.getGET /api/table/{id}read
and 4 more in this area

Transform job6

metabase.transform_job.createPOST /api/transform-jobwrite
metabase.transform_job.getGET /api/transform-job/{job-id}read
and 4 more in this area

API key5

metabase.api_key.createPOST /api/api-keywrite
metabase.api_key.deleteDELETE /api/api-key/{id}destructive
and 3 more in this area

Comment5

metabase.comment.createPOST /api/commentwrite
metabase.comment.listGET /api/commentread
and 3 more in this area

Ee custom viz plugin5

metabase.ee_custom_viz_plugin.dev_urlPUT /api/ee/custom-viz-plugin/{id}/dev-urlwrite
metabase.ee_custom_viz_plugin.listGET /api/ee/custom-viz-pluginread
and 3 more in this area

Ee scim V2 groups5

metabase.ee_scim_v2_groups.createPOST /api/ee/scim/v2/Groupswrite
metabase.ee_scim_v2_groups.getGET /api/ee/scim/v2/Groups/{id}read
and 3 more in this area

Ee scim V2 users5

metabase.ee_scim_v2_users.createPOST /api/ee/scim/v2/Userswrite
metabase.ee_scim_v2_users.getGET /api/ee/scim/v2/Users/{id}read
and 3 more in this area

MT gtap5

metabase.mt_gtap.createPOST /api/mt/gtapwrite
metabase.mt_gtap.getGET /api/mt/gtap/{id}read
and 3 more in this area

Permissions group5

metabase.permissions_group.createPOST /api/permissions/groupwrite
metabase.permissions_group.getGET /api/permissions/group/{id}read
and 3 more in this area

Permissions membership5

metabase.permissions_membership.createPOST /api/permissions/membershipwrite
metabase.permissions_membership.deleteDELETE /api/permissions/membership/{id}destructive
and 3 more in this area

Segment5

metabase.segment.createPOST /api/segmentwrite
metabase.segment.getGET /api/segment/{id}read
and 3 more in this area

Timeline5

metabase.timeline.createPOST /api/timelinewrite
metabase.timeline.getGET /api/timeline/{id}read
and 3 more in this area

Channel4

metabase.channel.createPOST /api/channelwrite
metabase.channel.getGET /api/channel/{id}read
and 2 more in this area

Ee tenant4

metabase.ee_tenant.createPOST /api/ee/tenantwrite
metabase.ee_tenant.getGET /api/ee/tenant/{id}read
and 2 more in this area

Glossary4

metabase.glossary.createPOST /api/glossarywrite
metabase.glossary.deleteDELETE /api/glossary/{id}destructive
and 2 more in this area

Index request4

metabase.index_request.createPOST /api/index/requestwrite
metabase.index_request.deleteDELETE /api/index/request/{id}destructive
and 2 more in this area

LLM providers4

metabase.llm_providers.createPOST /api/llm/providerswrite
metabase.llm_providers.deleteDELETE /api/llm/providers/{key}destructive
and 2 more in this area

Measure4

metabase.measure.createPOST /api/measurewrite
metabase.measure.getGET /api/measure/{id}read
and 2 more in this area

Metabot conversations 4Model index 4Native query snippet 4Osi AI context 4Persist card 4Pulse 4Timeline event 4Transform tag 4Agent V1 question 3Bookmark 3Cache 3Ee AI controls usage group 3Ee AI controls usage tenant 3Ee database replication connection 3Ee gsheets connection 3Ee replacement runs 3Ee support access grant 3Ee transforms inspect 3Metabot metabot 3Setting 3User key value namespace key 3Activity recents 2Agent V1 dashboard 2Agent V1 metric 2Alert 2Cloud migration 2Collection graph 2Dashboard dashcard card 2Database datasets 2Database schema 2Database schemas 2Dataset 2Ee advanced permissions application graph 2Ee advanced permissions impersonation 2Ee AI controls permissions 2Ee AI controls permissions advanced 2Ee AI controls usage instance 2Ee cloud add ons 2Ee content translation dictionary 2Ee email override 2Ee library 2Ee metabot analytics conversations 2Ee scim API key 2Ee security center 2Ee transforms python library 2Ee upload management tables 2Email 2Embed card query 2Geojson 2Logger adjustment 2Metabot metabot prompt suggestions 2Metric 2Metric dimension 2Notification admin 2Notify DB 2Permissions graph 2Persist 2Persist database 2Public action 2Public card query 2Public dashboard dashcard card 2Public document card 2Revision 2Search weights 2Session 2Task 2Task runs 2Transform job runs 2Transform run 2Action execute values 1Action public 1Action public link 1Activity most recently viewed dashboard 1Activity popular items 1Activity recent views 1Agent V1 collection 1Agent V1 construct native query 1Agent V1 execute 1Agent V1 execute SQL 1Agent V1 ping 1Agent V1 read resource 1Agent V1 search 1Agent V2 construct query 1Agent V2 query 1Alert subscription 1Analytics anonymous stats 1Analytics internal 1Analytics proxy 1API key count 1305 smaller areas 305

This index shows a sample of each area. All 668 actions, with their inputs and prices, are in the 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.

Give your agent Metabase today.

Connect Metabase free See pricing

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

Metabase MCP server for AI agents.

Connect Metabase in three steps.

Add actionlake to Claude.

Connect Metabase.

Make the first call. Check before a write.

What an AI agent can do in Metabase.

Apps

Card

Database

Transform

Dashboard

User

Action

Document