{"_id":"@cognitionai/metabase-mcp-server","_rev":"13-20d90e9c74930a28ae2000785ad0e442","name":"@cognitionai/metabase-mcp-server","dist-tags":{"latest":"2.2.0"},"versions":{"1.0.9":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.9","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.9","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"}],"homepage":"https://github.com/usacognition/metabase-mcp-server","bugs":{"url":"https://github.com/usacognition/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"8525e1a9f784daec90e185d17f09ac4496cb5039","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.9.tgz","fileCount":15,"integrity":"sha512-BB9X6znvNjHF4nD0IJtrrSKGFs6veplL/7eLQMvFGMsV8mRmMNJlrUmLt5OE58Pb5k2n799Xv79UA9Q5iqKi9w==","signatures":[{"sig":"MEUCIQDaj2/vBXBGisqg3zwO58Lfw4zPmZegFmtvAuNRVUIyEgIgOTZV4fg/o09Y6JjulSQ6Io/c0IZjsK39QRkmGA8kTgc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169068},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"6b0e4acfd2aeedc49bca72a7a29d1144f61d1df8","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"repository":{"url":"git+https://github.com/usacognition/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.9_1756303579015_0.5414281556097995","host":"s3://npm-registry-packages-npm-production"}},"1.0.10":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.10","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.10","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"3c5b9614ac44369280bd3aeabaddaa9f76c7338c","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.10.tgz","fileCount":15,"integrity":"sha512-/C5O/VQbOEcwXFh+dlz2TwLKUKSWp7Ozdegkq36eEH23Fbi1haY0pVeFDbbdf0MBnkcsvixTCz4whgpt5onkig==","signatures":[{"sig":"MEYCIQDhuGqvuS+gVwAp4XPM0QB5uEDIqo6QFAD7DBEd+fiXxQIhAOwq5lHxlOA0p941A++nFvmMNL28hSKue+B8mF1i7c0d","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169061},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"4ddb3536ac6cbd06550b0f17e59e60610e87efea","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.10_1756322994406_0.6982130945264056","host":"s3://npm-registry-packages-npm-production"}},"1.0.11":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.11","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.11","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"d456b9ebf9b356d5201c34892bfb9f5188b1cffc","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.11.tgz","fileCount":15,"integrity":"sha512-fp7capear/QlsmZf/IyTgqfbCIIyAUj7mpNpQWFyw3XF3vBEQunpIV2s/j1iwu5aPv0tCewQ1SK9JujQlqnpeQ==","signatures":[{"sig":"MEYCIQDRN2lAn1HEXVwNsnod1Ll4m6CsfOkyVQ44G3vOnPrQjAIhAPWIo7DHvYqYH4AA5Jba3DDSRxfqebFPX7UR3cvQ0H4h","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":171145},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"61e8424bf3050ad59247fbf12ba2b991a5ebb17e","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.11_1756416470821_0.7659595127821668","host":"s3://npm-registry-packages-npm-production"}},"1.0.12":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.12","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.12","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"d7b48f25c612f862c692498ed07d81c66e9b94bd","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.12.tgz","fileCount":15,"integrity":"sha512-hIjVM5zWVdIWSEH/CxYIEDYiSJIXrYzOJhTdzP+lqmHWGgg2D5WsoH0QMt6WgyNEBCJp8l0+IGHfwnPBq69HAw==","signatures":[{"sig":"MEUCIB56Af5lRxM+jL9a2j2sD1wY0iCMqY/PNIFmMVNBhdY2AiEAz3qL7RneMYw7erqpkmNhObuhJyEJS6SQzziVWQ/y4ls=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":173591},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"67e495d30f23bfd3b5cb1f0de75d019a36971bad","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.12_1756961970875_0.11893159965543121","host":"s3://npm-registry-packages-npm-production"}},"1.0.13":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.13","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.13","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"e8aaf5bd1c984f872bbc7ca431c81640093cbe9e","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.13.tgz","fileCount":15,"integrity":"sha512-5m3BagAqLBTKVkQg3kXKxElVx/26vov/qtBB8UvF3iGYndWjSIAghAXCeUETU05LxC7i66klWMBl+p2+xx5cUQ==","signatures":[{"sig":"MEUCIAteozkukErqr04GA9XZNRT24g7kpUKpTVbOO4FLV5e/AiEAiZdxNY6jTHN96vWzO0+7pLd94zAci0n9yFxwPR8CpfI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":173630},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"6675cea8d3c62619d05706a31d8d8ec3f35196e6","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.13_1758031972330_0.6112947758399387","host":"s3://npm-registry-packages-npm-production"}},"1.0.14":{"name":"@cognitionai/metabase-mcp-server","version":"1.0.14","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@1.0.14","maintainers":[{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"},{"name":"nikhil-cognition","email":"nikhil@cognition.ai"},{"name":"silasalberti","email":"silasleonalberti@gmail.com"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"30dfef27ce03871729fd1798352b4376c0e31fb3","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-1.0.14.tgz","fileCount":15,"integrity":"sha512-2nWeAr3hyImgoJNuVKTXXujbKfDJLNyeru4ZXpKw3/OtQeo8n9Ja+Rv8e95KLq+PhwsLofolszRIHQHmS/o5hA==","signatures":[{"sig":"MEYCIQCjr8Cr/1VFEImbM209MThF2pSB34nZ8iNYVtmnNI/0ZQIhAPkvZqkFku62ct5iRxV6HeYVeSqMaVzs/p5GIFYARr1k","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":173719},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"19f80dc1eb5543cbc3bc791facaeb1138313e39b","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/* dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"marcosfede","email":"marcosfede@gmail.com"},"overrides":{"fastmcp":{"@modelcontextprotocol/sdk":"1.22.0"}},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"^3.14.5","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_1.0.14_1764171981682_0.4781418820096457","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@cognitionai/metabase-mcp-server","version":"2.2.0","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","_id":"@cognitionai/metabase-mcp-server@2.2.0","maintainers":[{"name":"jeffrey-cognition","email":"jeffrey@cognition.ai"},{"name":"etw-cognition","email":"ethan@cognition.ai"},{"name":"ryan-cognition","email":"ryan@cognition.ai"},{"name":"marcosfede","email":"marcosfede@gmail.com"},{"name":"ginkoid","email":"g@gnk.io"},{"name":"nikhil-cognition","email":"nikhil@cognition.ai"},{"name":"silasalberti","email":"silasleonalberti@gmail.com"}],"homepage":"https://github.com/CognitionAI/metabase-mcp-server","bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"bin":{"metabase-mcp-server":"dist/server.js"},"dist":{"shasum":"7d6b5ca0fbf7fd4dc7bf2789d7c62c2bb9bc2c57","tarball":"https://registry.npmjs.org/@cognitionai/metabase-mcp-server/-/metabase-mcp-server-2.2.0.tgz","fileCount":14,"integrity":"sha512-8GEo3Ol0esZ7KbcgvHmMS+ajuLHjwIwkGI/J6I02Aijo3RPf+1n1nANuRzzZLsWwT8HSYMwWA/Guy4ulxN8PxA==","signatures":[{"sig":"MEUCIQCD0IQ6c0miGBuP+B8qLEhkeGAJs5+iqqPUpBYp6KEJgAIgBwFExihJ9g6ZxsOIe2Sd99u/s9BmRMqhwm5JMIx3bcg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@cognitionai%2fmetabase-mcp-server@2.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":198907},"main":"./dist/server.js","type":"module","engines":{"npm":">=8.0.0","node":">=20.19.0"},"gitHead":"a8981ab4788780ea9e067fb4714b7e37c60c6475","private":false,"scripts":{"dev":"npx fastmcp dev src/server.ts","build":"npm run clean && tsc && node -e \"require('fs').chmodSync('build/server.js', '755')\" && mkdir -p dist && cp -r build/. dist/","clean":"rm -rf build dist","start":"npm run build && node dist/server.js","watch":"tsc --watch","prepack":"npm run build","inspector":"npm run build && npx fastmcp inspect dist/server.js","docker:run":"docker run -it --rm metabase-mcp-server","docker:build":"docker build -t metabase-mcp-server .","docker:compose":"docker-compose up"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fe1f7b1c-6d5a-4269-969a-6ff50b0bf13f"}},"overrides":{"fastmcp":{"@modelcontextprotocol/sdk":"1.22.0"}},"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"_npmVersion":"11.19.0","description":"A Model Context Protocol server for Metabase integration","directories":{},"_nodeVersion":"24.19.0","dependencies":{"cors":"^2.8.5","axios":"^1.8.2","express":"^5.1.0","fastmcp":"3.23.1","mcp-proxy":"5.11.2","abort-controller":"^3.0.0","@modelcontextprotocol/sdk":"^0.6.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.17.22"},"_npmOperationalInternal":{"tmp":"tmp/metabase-mcp-server_2.2.0_1787000574643_0.1216644364766335","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-08-27T14:06:18.947Z","modified":"2026-09-17T01:01:14.450Z","1.0.9":"2025-08-27T14:06:19.173Z","1.0.10":"2025-08-27T19:29:54.596Z","1.0.11":"2025-08-28T21:27:51.031Z","1.0.12":"2025-09-04T04:59:31.078Z","1.0.13":"2025-09-16T14:12:52.502Z","1.0.14":"2025-11-26T15:46:21.871Z","2.2.0":"2026-08-17T21:02:54.811Z"},"bugs":{"url":"https://github.com/CognitionAI/metabase-mcp-server/issues"},"author":{"name":"Cognition","email":"devin@cognition.ai"},"license":"MIT","homepage":"https://github.com/CognitionAI/metabase-mcp-server","keywords":["mcp","model-context-protocol","metabase","analytics","business-intelligence","ai","claude"],"repository":{"url":"git+https://github.com/CognitionAI/metabase-mcp-server.git","type":"git"},"description":"A Model Context Protocol server for Metabase integration","maintainers":[{"email":"jeffrey@cognition.ai","name":"jeffrey-cognition"},{"email":"morgante.pell@morgante.net","name":"morgante"},{"email":"ethan@cognition.ai","name":"etw-cognition"},{"email":"ryan@cognition.ai","name":"ryan-cognition"},{"email":"marcosfede@gmail.com","name":"marcosfede"},{"email":"g@gnk.io","name":"ginkoid"},{"email":"nikhil@cognition.ai","name":"nikhil-cognition"},{"email":"silasleonalberti@gmail.com","name":"silasalberti"}],"readme":"# Readme: Metabase MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@cognitionai/metabase-mcp-server)](https://www.npmjs.com/package/@cognitionai/metabase-mcp-server)\n[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white)](https://nodejs.org/)\n\nA comprehensive Model Context Protocol (MCP) server for Metabase integration, providing AI assistants with full access to Metabase's analytics platform.\n\n## 🚀 Quick Start\n\n```bash\n# Install and run with npx\nexport METABASE_URL=https://your-metabase-instance.com\nexport METABASE_API_KEY=your_metabase_api_key\nnpx @cognitionai/metabase-mcp-server\n```\n\n## ✨ Features\n\n### 🎯 **81+ Tools Available** - Complete Metabase API Coverage\n\n- **📊 Dashboard Management** (23 tools) - Full CRUD operations, card management, public sharing, embedding\n- **📈 Card/Question Management** (21 tools) - Query execution, parameter handling, pivot queries, public links\n- **🗄️ Database Management** (13 tools) - Connection management, schema sync, query execution\n- **📋 Table Management** (16 tools) - Metadata operations, field management, data operations\n- **🔍 Additional Tools** (9 tools) - Collections, search, users, activity tracking, playground links\n\n## 📦 Installation\n\n> **💡 Recommended:** Node.js 20.19.0+ and npm 8.0.0+ for optimal compatibility\n\n### Method 1: NPX (Recommended)\n```bash\nnpx @cognitionai/metabase-mcp-server\n```\n\n### Method 2: Global Installation\n```bash\nnpm install -g @cognitionai/metabase-mcp-server\nmetabase-mcp-server\n```\n\n### Method 3: Docker\n```bash\ndocker run -it --rm \\\n  -e METABASE_URL=https://your-metabase-instance.com \\\n  -e METABASE_API_KEY=your_metabase_api_key \\\n  ghcr.io/CognitionAI/metabase-mcp-server\n```\n\n## ⚙️ Configuration\n\n### Environment Variables\n\n**API Key Authentication (Preferred):**\n```bash\nexport METABASE_URL=https://your-metabase-instance.com\nexport METABASE_API_KEY=your_metabase_api_key\n```\n\n**Username/Password Authentication (Fallback):**\n```bash\nexport METABASE_URL=https://your-metabase-instance.com\nexport METABASE_USERNAME=your_username\nexport METABASE_PASSWORD=your_password\n```\n\n### Optional Arguments\n\nThe server supports command-line arguments to customize tool loading:\n\n- **`--essential`** (default): Load only essential tools\n- **`--all`**: Load all 80+ available tools\n- **`--write`**: Load only write/modification tools\n- **`--read`**: Load only read-only tools\n\n```bash\n# Using published package (recommended)\n# Default behavior (essential tools only)\nnpx @cognitionai/metabase-mcp-server\n\n# Load all tools\nnpx @cognitionai/metabase-mcp-server --all\n\n# Load only write tools\nnpx @cognitionai/metabase-mcp-server --write\n\n# Load only read-only tools\nnpx @cognitionai/metabase-mcp-server --read\n\n# Using local development build\nnpm run build\nnode dist/server.js                    # Default (essential tools)\nnode dist/server.js --all             # All tools\nnode dist/server.js --write           # Write tools only\nnode dist/server.js --read            # Read-only tools only\n```\n\n## 🔌 Integration Examples\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n**Using published package:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cognitionai/metabase-mcp-server\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n**Using local development build:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/metabase-mcp-server/dist/server.js\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n**With custom flags:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase-all\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cognitionai/metabase-mcp-server\", \"--all\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf IDE\n\nAdd to your Windsurf MCP config (`~/.windsurf/mcp_config.json`):\n\n**Using published package:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cognitionai/metabase-mcp-server\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n**Using local development build:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/metabase-mcp-server/dist/server.js\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n**With custom flags:**\n```json\n{\n  \"mcpServers\": {\n    \"metabase-read\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cognitionai/metabase-mcp-server\", \"--read\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    },\n    \"metabase-write\": {\n      \"command\": \"npx\",\n      \"args\": [\"@cognitionai/metabase-mcp-server\", \"--write\"],\n      \"env\": {\n        \"METABASE_URL\": \"https://your-metabase-instance.com\",\n        \"METABASE_API_KEY\": \"your_metabase_api_key\"\n      }\n    }\n  }\n}\n```\n\n## 🛠️ Available Tools\n\n<details>\n<summary><strong>📊 Dashboard Management (23 tools)</strong></summary>\n\n### Core Operations\n- `list_dashboards` - List all dashboards\n- `get_dashboard` - Get dashboard by ID\n- `create_dashboard` - Create new dashboard\n- `update_dashboard` - Update existing dashboard\n- `delete_dashboard` - Delete dashboard\n- `copy_dashboard` - Copy dashboard\n\n### Card Management\n- `get_dashboard_cards` - Get all cards in dashboard\n- `add_card_to_dashboard` - Add card to dashboard\n- `remove_card_from_dashboard` - Remove card from dashboard\n- `update_dashboard_card` - Update card position/settings\n- `execute_dashboard_card` - Execute specific dashboard card\n\n### Public Sharing & Embedding\n- `create_public_link` - Create public dashboard link\n- `delete_public_link` - Delete public dashboard link\n- `list_public_dashboards` - List public dashboards\n- `list_embeddable_dashboards` - List embeddable dashboards\n\n### Parameters & Queries\n- `get_dashboard_param_values` - Get parameter values\n- `search_dashboard_param_values` - Search parameter values\n- `get_dashboard_param_remapping` - Get parameter remapping\n- `execute_dashboard_query` - Execute dashboard queries\n\n### Advanced Features\n- `get_dashboard_related` - Get related content\n- `get_dashboard_query_metadata` - Get query metadata\n- `update_dashboard_cards` - Bulk update cards\n- `save_dashboard` - Save dashboard changes\n- `get_dashboard_items` - Get dashboard items\n\n</details>\n\n<details>\n<summary><strong>📈 Card/Question Management (21 tools)</strong></summary>\n\n### Core Operations\n- `list_cards` - List all cards/questions\n- `get_card` - Get card by ID\n- `create_card` - Create new card\n- `update_card` - Update existing card\n- `delete_card` - Delete card\n- `copy_card` - Copy card\n\n### Query Execution\n- `execute_card` - Execute card query\n- `execute_card_query_with_format` - Execute with specific format\n- `execute_pivot_card_query` - Execute pivot query\n- `get_card_query_metadata` - Get query metadata\n\n### Card Management\n- `move_cards` - Move cards between collections\n- `move_cards_to_collection` - Bulk move to collection\n- `get_card_dashboards` - Get dashboards containing card\n- `get_card_series` - Get card series data\n\n### Parameters & Values\n- `get_card_param_values` - Get parameter values\n- `search_card_param_values` - Search parameter values\n- `get_card_param_remapping` - Get parameter remapping\n\n### Public Sharing\n- `create_card_public_link` - Create public card link\n- `delete_card_public_link` - Delete public card link\n- `get_public_cards` - List public cards\n- `get_embeddable_cards` - List embeddable cards\n\n</details>\n\n<details>\n<summary><strong>🗄️ Database Management (13 tools)</strong></summary>\n\n### Core Operations\n- `list_databases` - List all databases\n- `get_database` - Get database details\n- `create_database` - Create database connection\n- `update_database` - Update database settings\n- `delete_database` - Delete database connection\n\n### Schema & Metadata\n- `get_database_schema_tables` - Get database tables\n- `get_database_schemas` - Get database schemas\n- `get_database_metadata` - Get complete metadata\n- `sync_database_schema` - Sync schema metadata\n\n### Query Operations\n- `execute_query` - Execute SQL queries\n- `execute_query_export` - Execute and export results\n\n### Maintenance\n- `get_database_usage_info` - Get usage statistics\n- `rescan_database_field_values` - Rescan field values\n\n</details>\n\n<details>\n<summary><strong>📋 Table Management (16 tools)</strong></summary>\n\n### Core Operations\n- `list_tables` - List tables with filtering\n- `get_table` - Get table details\n- `update_table` - Update table configuration\n- `update_tables` - Bulk update tables\n\n### Data Operations\n- `get_table_data` - Retrieve table data\n- `append_csv_to_table` - Append CSV data\n- `replace_table_csv` - Replace with CSV data\n\n### Schema & Relationships\n- `get_table_query_metadata` - Get query metadata\n- `get_table_fks` - Get foreign key relationships\n- `get_table_related` - Get related tables\n- `sync_table_schema` - Sync table schema\n\n### Field Management\n- `reorder_table_fields` - Reorder field display\n- `rescan_table_field_values` - Rescan field values\n- `discard_table_field_values` - Discard cached values\n\n### Card Integration\n- `get_card_table_fks` - Get card table foreign keys\n- `get_card_table_query_metadata` - Get card table metadata\n\n</details>\n\n<details>\n<summary><strong>🔍 Additional Tools (9 tools)</strong></summary>\n\n### Collections\n- `list_collections` - List all collections\n- `create_collection` - Create new collection\n- `update_collection` - Update collection\n- `delete_collection` - Delete collection\n- `get_collection_items` - Get collection items\n\n### Search & Discovery\n- `search_content` - Search across all content\n\n### Activity & Analytics\n- `get_recent_views` - Get recent activity\n- `get_popular_items` - Get popular content\n\n### Playground Links\n- `get_metabase_playground_link` - Generate interactive playground links\n\n</details>\n\n## 🧪 Development\n\n### Setup\n```bash\ngit clone https://github.com/CognitionAI/metabase-mcp-server.git\ncd metabase-mcp-server\nnpm install\n```\n\n### Build\n```bash\nnpm run build\n```\n\n### Development Mode\n```bash\nnpm run watch\n```\n\n### Debugging\nUse the MCP Inspector for debugging:\n```bash\nnpm run inspector\n```\n\n## 🔍 Testing Authentication\n\n### API Key Authentication\n1. Set `METABASE_URL` and `METABASE_API_KEY`\n2. Start server and verify \"Using Metabase API Key\" in logs\n3. Test with `list_dashboards` tool\n\n### Username/Password Authentication\n1. Unset `METABASE_API_KEY`\n2. Set `METABASE_URL`, `METABASE_USERNAME`, `METABASE_PASSWORD`\n3. Start server and verify \"Using username/password\" in logs\n4. Test with `list_dashboards` tool\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n**Authentication Errors:**\n- Verify your Metabase URL is accessible\n- Check API key validity in Metabase admin settings\n- Ensure username/password credentials are correct\n\n**Connection Issues:**\n- Confirm Metabase instance is running\n- Check network connectivity\n- Verify SSL certificates if using HTTPS\n\n**Tool Execution Errors:**\n- Check Metabase permissions for your user/API key\n- Verify the requested resource exists\n- Review server logs for detailed error messages\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please visit our [GitHub repository](https://github.com/CognitionAI/metabase-mcp-server) to:\n\n- 🐛 Report bugs\n- 💡 Request features  \n- 🔧 Submit pull requests\n- 📖 Improve documentation\n\n### Development Guidelines\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes with tests\n4. Ensure all tests pass\n5. Submit a pull request\n\n## 🆘 Support\n\n- 📚 [Documentation](https://github.com/CognitionAI/metabase-mcp-server/wiki)\n- 🐛 [Issue Tracker](https://github.com/CognitionAI/metabase-mcp-server/issues)\n\n---\n\nBuilt with ❤️ for the world\n","readmeFilename":"README.md"}