Skip to content
MCP server

Medusa

Medusa v2 store: orders, customers, products, inventory, sales reports and safe write…

Runs locallyStatus and history
Install
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-mcp

Add 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.comRequired
  • MEDUSA_API_KEYSecret API key from Medusa Admin → Settings → Developer → Secret API Keys (sk_…)Required
  • MEDUSA_READ_ONLYtrue = register read and report tools only
  • REPORT_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

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data