# Shopware MCP

> Shopware MCP is an open-source MCP server for e-commerce. Query and audit a Shopware 6 shop, with a read-only default and dry-run writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/bnymndev/shopware-mcp
- **MCP Registry name:** io.github.bnymnDev/shopware-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Skybridge Ecommerce Example](https://ai-powered.com/mcp/skybridge-ecommerce-example): Skybridge Ecommerce Example is an open-source MCP server for e-commerce.
- [GoAI Moat Xiaohongshu Products](https://ai-powered.com/mcp/goai-moat-xiaohongshu-products): GoAI Moat Xiaohongshu Products is an MCP server for e-commerce.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/shopware-mcp
