Medusa v2 store: orders, customers, products, inventory, sales reports and safe write actions.
Connect Runs on your machine
claude mcp add medusa-mcp -e MEDUSA_BACKEND_URL=<MEDUSA_BACKEND_URL> -e MEDUSA_API_KEY=<MEDUSA_API_KEY> -e MEDUSA_READ_ONLY=<MEDUSA_READ_ONLY> -e REPORT_TIMEZONE=<REPORT_TIMEZONE> -- npx -y [email protected]
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>",
"MEDUSA_READ_ONLY": "<MEDUSA_READ_ONLY>",
"REPORT_TIMEZONE": "<REPORT_TIMEZONE>"
}
}
}
}
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>",
"MEDUSA_READ_ONLY": "<MEDUSA_READ_ONLY>",
"REPORT_TIMEZONE": "<REPORT_TIMEZONE>"
}
}
}
}
{
"servers": {
"medusa-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>",
"MEDUSA_READ_ONLY": "<MEDUSA_READ_ONLY>",
"REPORT_TIMEZONE": "<REPORT_TIMEZONE>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MEDUSA_BACKEND_URLRequired | URL of your Medusa backend, e.g. https://api.example.com |
MEDUSA_API_KEYRequired, secret | Secret API key from Medusa Admin → Settings → Developer → Secret API Keys (sk_…) |
MEDUSA_READ_ONLYOptional | true = register read and report tools only |
REPORT_TIMEZONEOptional | IANA timezone for date filters and report buckets, e.g. Europe/Prague |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 5 Oct 2026 |
| Last updated | 5 Oct 2026 |
| Registry name | io.github.trhonpavel/medusa-mcp |
More data and analytics servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
