Skip to content
MCP server

Shopware MCP

Query and audit a Shopware 6 shop, with a read-only default and dry-run writes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.11.1
Listing updated
today

Similar MCP servers

About Shopware MCP

Shopware MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

Rather than exposing Shopware's roughly two hundred entities raw, this server offers about twenty curated tools that return compact JSON with exact totals, plus escape hatches (entity_schema and entity_search) for anything else. It is built around questions a shop owner asks: is the checkout working, will a promotion break, what runs out soon.

The checkout_simulate tool builds a throwaway cart through the Store API and explains errors in plain words, and shop_pulse compares today's orders with the same hours of the same weekday in recent weeks to spot a silent spell. shop_audit runs eighteen checks in one call, while promotion_impact and margin_check estimate what a discount costs. agent_readiness builds the product feed AI shopping agents read, and update_check asks Shopware's update service which extensions work with the next version. A watch command posts to Slack only when something changes.

It is read-only unless started with --allow-write, and even then writes are dry runs that show the exact request, optionally capped by a write budget. Setup needs the shop URL and an Integration's client ID and secret.

Install

Run in a terminal

claude mcp add shopware-mcp --env SHOPWARE_URL='<SHOPWARE_URL>' --env SHOPWARE_CLIENT_ID='<SHOPWARE_CLIENT_ID>' --env SHOPWARE_CLIENT_SECRET='<SHOPWARE_CLIENT_SECRET>' -- npx -y shopware-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shopware-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shopware-mcp"
      ],
      "env": {
        "SHOPWARE_URL": "<SHOPWARE_URL>",
        "SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
        "SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shopware-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shopware-mcp"
      ],
      "env": {
        "SHOPWARE_URL": "<SHOPWARE_URL>",
        "SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
        "SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "shopware-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "shopware-mcp"
      ],
      "env": {
        "SHOPWARE_URL": "<SHOPWARE_URL>",
        "SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
        "SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shopware-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shopware-mcp"
      ],
      "env": {
        "SHOPWARE_URL": "<SHOPWARE_URL>",
        "SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
        "SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shopware-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shopware-mcp"
      ],
      "env": {
        "SHOPWARE_URL": "<SHOPWARE_URL>",
        "SHOPWARE_CLIENT_ID": "<SHOPWARE_CLIENT_ID>",
        "SHOPWARE_CLIENT_SECRET": "<SHOPWARE_CLIENT_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHOPWARE_URLShop base URL, e.g. https://shop.example.comRequired
  • SHOPWARE_CLIENT_IDIntegration access key IDRequired
  • SHOPWARE_CLIENT_SECRETIntegration secret access keyRequired
  • SHOPWARE_MCP_ALLOW_WRITESet to true to register the guarded write tools

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

checkout_simulate
Simulates a throwaway cart and explains errors.
storefront_search
Searches like a customer and explains missing products.
shop_pulse
Compares today's orders with usual weekday patterns.
promotions_check
Finds what would stop upcoming promotions.
shop_diagnose
Looks at likely causes of shop problems.
journeys_run
Runs fixed buying paths through the real cart.
agent_readiness
Builds the AI shopping agent product feed and flags gaps.
update_check
Reports upcoming updates and extension compatibility.
shop_brief
Summarises the shop.
shop_audit
Runs eighteen audit checks.
sales_report
Aggregates sales by period, channel and product.
customer_report
Reports on new, guest and repeat customers.
stock_forecast
Forecasts days of cover and reorder quantities.
returns_report
Reports returned orders and products.
promotion_impact
Replays a discount on recent orders.
margin_check
Finds products sold below purchase price.
entity_schema
Describes any Shopware entity.
entity_search
Queries any entity with Shopware filters and aggregations.

What it does

Curated shop tools
Products, orders, customers, stock, promotions and more as compact JSON.
Checkout simulation
Tries a throwaway cart and explains why it fails.
Order pulse and watch
Detects unusual quiet and alerts Slack with a likely cause.
Shop audit
Eighteen checks plus rule packs for GPSR and accessibility.
Reports and forecasts
Sales, customer, returns and stock run-out reports.
Guarded writes
Read-only by default; writes show a dry run first.

Good for

  • Find out why orders suddenly stopped
  • Check promotions before a campaign day
  • Forecast which products run out and when
  • Test whether a customer could check out
  • Prepare a product feed for AI shopping agents

Pricing

Open source

Free npm package

Shopware MCP FAQ

Can it change my shop?

Only if started with --allow-write, and each write is first shown as a dry run.

What credentials are needed?

SHOPWARE_URL, SHOPWARE_CLIENT_ID and SHOPWARE_CLIENT_SECRET from an Integration.

Is there a hosted version?

Yes. A hosted mode serves many shops through OAuth, read-only.

Will it place orders when simulating checkout?

No. Nothing is ordered and the cart is deleted.

Is Shopware MCP free?

Yes. Shopware MCP is open source, so you can use and self-host it for free.

How do I add Shopware MCP to Claude Code?

Run this command in your terminal: claude mcp add shopware-mcp --env SHOPWARE_URL='<SHOPWARE_URL>' --env SHOPWARE_CLIENT_ID='<SHOPWARE_CLIENT_ID>' --env SHOPWARE_CLIENT_SECRET='<SHOPWARE_CLIENT_SECRET>' -- npx -y shopware-mcp

What are the best alternatives to Shopware MCP?

The closest alternatives to Shopware MCP are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Trackkr MCP Server — Smart Lockerless Parcel Management and Zovo Product Recall Check.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers