cuenca-mx/metabase-mcp-server
3.3
If you are the rightful owner of metabase-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project implements an MCP server to interact with the Metabase API, providing a structured interface for key functionalities.
Metabase MCP Server
This project implements an MCP server to interact with the Metabase API, exposing key functionality via a MCP interface.
Features
- ๐ List Metabase cards
- ๐๏ธ List available databases
- ๐ Execute queries on cards
- ๐งพ Run arbitrary queries
- ๐ Create new cards
- ๐ Create bookmark
- ๐ List collections
Requirements
- Python 3.12+
- uv
Installation
- Clone the repository:
git clone https://github.com/cuenca-mx/metabase-mcp-server.git
cd metabase-mcp-server
{
"mcpServers": {
"metabase": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/metabase_mcp_server",
"run",
"app.py"
],
"env": {
"METABASE_URL": "https://metabase.domain.com/",
"METABASE_API_KEY": "your-secret-api-key"
}
}
}
}
Development Setup
This project uses a Makefile to simplify development tasks:
make install
Environment Variables
Configure required environment variables:
export $(<env.template)
Running Tests
The project uses pytest
for unit testing:
uv run pytest
Debugging with MCP Inspector
Use the MCP Inspector for testing and debugging:
make dev