Medusa
Medusa v2 store: orders, customers, products, inventory, sales reports and safe write…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 4 days ago
About Medusa
Medusa is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
Medusa v2 store: orders, customers, products, inventory, sales reports and safe write actions.
Install
Run in a terminal
claude mcp add medusa-mcp --env MEDUSA_BACKEND_URL='<MEDUSA_BACKEND_URL>' --env MEDUSA_API_KEY='<MEDUSA_API_KEY>' -- npx -y medusa-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"medusa-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"medusa-mcp": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "<MEDUSA_BACKEND_URL>",
"MEDUSA_API_KEY": "<MEDUSA_API_KEY>"
}
}
}
}Configuration
MEDUSA_BACKEND_URLURL of your Medusa backend, e.g. https://api.example.comRequiredMEDUSA_API_KEYSecret API key from Medusa Admin → Settings → Developer → Secret API Keys (sk_…)RequiredMEDUSA_READ_ONLYtrue = register read and report tools onlyREPORT_TIMEZONEIANA timezone for date filters and report buckets, e.g. Europe/Prague
Pricing
Open source
Medusa FAQ
Is Medusa free?
Yes. Medusa is open source, so you can use and self-host it for free.
How do I add Medusa to Claude Code?
Run this command in your terminal: claude mcp add medusa-mcp --env MEDUSA_BACKEND_URL='<MEDUSA_BACKEND_URL>' --env MEDUSA_API_KEY='<MEDUSA_API_KEY>' -- npx -y medusa-mcp
What are the best alternatives to Medusa?
The closest alternatives to Medusa are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).
Alternatives to Medusa
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce

Renta
MCP serverRemote MCP server for running an outdoor rental shop on Renta from an AI client
- Remote
- Paid
- E-commerce

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce

repairinfo
MCP serverRepairability scores and spare-parts years for EU appliances and electronics
- 4 tools
- Remote
- Freemium
- Analytics and data