Medusa
CommunityMCP server by trhonpavel · updated · ★ 0 · 42 downloads a week
Medusa v2 store: orders, customers, products, inventory, sales reports and safe write actions. Medusa is a community project by trhonpavel, not verified by a company domain.
Install Medusa
Built from the published package, never by AIclaude mcp add medusa -e MEDUSA_BACKEND_URL=YOUR_MEDUSA_BACKEND_URL -e MEDUSA_API_KEY=YOUR_MEDUSA_API_KEY -- npx -y medusa-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"medusa": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "YOUR_MEDUSA_BACKEND_URL",
"MEDUSA_API_KEY": "YOUR_MEDUSA_API_KEY"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"medusa": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "YOUR_MEDUSA_BACKEND_URL",
"MEDUSA_API_KEY": "YOUR_MEDUSA_API_KEY"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"medusa": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "YOUR_MEDUSA_BACKEND_URL",
"MEDUSA_API_KEY": "YOUR_MEDUSA_API_KEY"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add medusa --env MEDUSA_BACKEND_URL=YOUR_MEDUSA_BACKEND_URL --env MEDUSA_API_KEY=YOUR_MEDUSA_API_KEY -- npx -y medusa-mcp{
"mcpServers": {
"medusa": {
"command": "npx",
"args": [
"-y",
"medusa-mcp"
],
"env": {
"MEDUSA_BACKEND_URL": "YOUR_MEDUSA_BACKEND_URL",
"MEDUSA_API_KEY": "YOUR_MEDUSA_API_KEY"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add medusa npx -y medusa-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the medusa block.
Last commit 18 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
MEDUSA_Environment variable | Required | URL of your Medusa backend, e.g. https://api.example.com |
MEDUSA_Environment variable, secret | Required | Secret API key from Medusa Admin → Settings → Developer → Secret API Keys (sk_…) |
MEDUSA_Environment variable | Optional | true = register read and report tools only Default: false |
REPORT_Environment variable | Optional | IANA timezone for date filters and report buckets, e.g. Europe/Prague Default: UTC |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like Medusa? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to Medusa
All alternatives →(For Internal Use Only) Provides MCP Tools for Salesforce Code Analyzer to a MCP Server
Conduyt CRM tools for AI agents: contacts, deals, pipelines, tasks, automations, messaging, reports
MCP Server for interacting with Salesforce instances
Official MCP server for Brilliant Directories — manage members, posts, leads, reviews, and more.
Model Context Protocol (MCP) server for Apollo.io API integration
Keywords or handles in, a finished influencer lead list with contact details out.
Medusa: common questions
How do I install Medusa?
In Claude Code run claude mcp add medusa -e MEDUSA_BACKEND_URL=YOUR_MEDUSA_BACKEND_URL -e MEDUSA_API_KEY=YOUR_MEDUSA_API_KEY -- npx -y medusa-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Medusa the official server?
Medusa is a community project by trhonpavel, not verified by a company domain.
Is Medusa free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Medusa safe to use?
It scores 67 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to Medusa?
Similar MCP servers: MCP Provider Code Analyzer, Conduyt CRM, Salesforce MCP, brilliant-directories-mcp.
Does Medusa work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
