# shopware-mcp

MCP server for managing a Shopware 6 shop through Claude Code and other editors: products, orders, stock, storefront audit, and sales forecasts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18 repo stars
- Author: bnymnDev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bnymnDev/shopware-mcp
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shopware-mcp

## What it does

The server connects an AI agent to a Shopware 6 Admin API and provides twenty instruments instead of raw access to two hundred entities: orders with history, customers, products, categories, promotions, reviews, stock, sales channels, documents. The `shop_pulse` instrument compares the current day with matching hours of past weeks and shows whether a quiet spell is normal or the storefront broke. `shop_audit` checks seventeen points in one call: paid orders without shipment, products without cover images or hidden in all channels, promotions past their end date, scheduled tasks that stopped running, legal pages of the storefront, reviews awaiting moderation.

\`checkout_simulate` places items and promo codes into a throwaway cart through the Store API as a guest or a specified customer, applies their group's pricing rules, and explains every cart error: a country outside the channel's shipping zone, an expired code, a payment method hidden by a rule, a parent product without a selected variant. No order is created; the cart is deleted. `sales_report` and `customer_report` aggregate revenue, average order value, top products and customers, timelines by day and week with optional comparison against the previous period. `stock_forecast` turns sales velocity into days of cover and stock run-out dates.

The server operates read-only by default. The `--allow-write` flag enables fifteen write operations, each shown as a dry run with the exact request first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHOPWARE_URL`, `SHOPWARE_CLIENT_ID`, `SHOPWARE_CLIENT_SECRET`, `SHOPWARE_MCP_ALLOW_WRITE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHOPWARE_URL=<SHOPWARE_URL> --env SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> --env SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> --env SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> --transport stdio shopware-mcp -- npx -y shopware-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add shopware-mcp --env SHOPWARE_URL=<SHOPWARE_URL> --env SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> --env SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> --env SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> -- npx -y shopware-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.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>",
                "SHOPWARE_MCP_ALLOW_WRITE": "<SHOPWARE_MCP_ALLOW_WRITE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.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>",
                "SHOPWARE_MCP_ALLOW_WRITE": "<SHOPWARE_MCP_ALLOW_WRITE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHOPWARE_URL=<SHOPWARE_URL> -e SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> -e SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> -e SHOPWARE_MCP_ALLOW_WRITE=<SHOPWARE_MCP_ALLOW_WRITE> shopware-mcp npx -y shopware-mcp
```
Replace <…> with your own values

## When to use it
- Check why no orders came in for six hours
- Find paid orders without shipment or invoice
- Simulate checkout as a customer of a specific group and see cart errors
- Aggregate revenue, top products, and average order value for a period with timeline
- Forecast the run-out date of a product at the current sales pace

## Example prompts
- Run a shop audit and show what needs attention
- Compare today with matching hours of past weeks — is the quiet spell normal
- Put product `SW10003` in a cart as customer ID `a1b2c3d4` and explain errors

## Similar
- [google-analytics-admin-api-basics](https://affpapa.org/en/nevibecode/skills/google-analytics-admin-api-basics.md) — skill · 7068 installs
- [planetscale-customer-report-template](https://affpapa.org/en/nevibecode/skills/planetscale-customer-report-template.md) — skill · 1900 installs
- [handover-admin](https://affpapa.org/en/nevibecode/skills/handover-admin.md) — skill · 770 installs
- [qveris](https://affpapa.org/en/nevibecode/skills/qveris.md) — skill · 484 installs
- [inventory-reorder-planner](https://affpapa.org/en/nevibecode/skills/inventory-reorder-planner.md) — skill · 103 installs
- [mantis-report](https://affpapa.org/en/nevibecode/skills/mantis-report.md) — skill · 1600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
