Install guide · Cursor
Install Metabase MCP (headless) for Cursor
Cursor reads ~/.cursor/mcp.json. A project can also commit .cursor/mcp.json.
Add to Cursor: Metabase MCP (headless)Install in VS Code: Metabase MCP (headless)Install in VS Code Insiders: Metabase MCP (headless)
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/.cursor/mcp.json on macOS, %USERPROFILE%\.cursor\mcp.json on Windows, or ~/.cursor/mcp.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "serdnaley-metabase-mcp": { "command": "npx", "args": [ "-y", "@serdnaley/metabase-mcp@0.5.0" ], "env": { "METABASE_URL": "", "METABASE_API_KEY": "YOUR_METABASE_API_KEY", "METABASE_EMAIL": "", "METABASE_PASSWORD": "YOUR_METABASE_PASSWORD", "METABASE_READ_ONLY_MODE": "", "METABASE_TOOLSETS": "", "METABASE_TOOLS_ENABLE": "", "METABASE_TOOLS_DISABLE": "", "METABASE_CUSTOM_HEADERS": "YOUR_METABASE_CUSTOM_HEADERS" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/.cursor/mcp.json |
| Windows | %USERPROFILE%\.cursor\mcp.json |
| Linux | ~/.cursor/mcp.json |