Skip to main content
MCP server CX Codex

shopware-mcp — Shopware 6 MCP server: what it does, how to install

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

MIT ★ 18 updated 2026-10-18

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What shopware-mcp 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.

What it helps with

  • 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 for the agent

  • 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

How to install shopware-mcp

Platform CLI

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about shopware-mcp

How do I install shopware-mcp in Claude Code?

Run `claude mcp add shopware-mcp -e SHOPWARE_URL=<SHOPWARE_URL> -e SHOPWARE_CLIENT_ID=<SHOPWARE_CLIENT_ID> -e SHOPWARE_CLIENT_SECRET=<SHOPWARE_CLIENT_SECRET> -- npx -y shopware-mcp`, substituting your shop URL and OAuth integration credentials.

What does shopware-mcp do?

It gives an AI agent twenty instruments for working with a Shopware 6 shop: orders, customers, products, stock, storefront audit, checkout simulation as a customer, aggregated reports, and sales forecasts. Operates read-only by default.

Can shopware-mcp change shop data?

Yes, pass the --allow-write flag at startup or set the environment variable SHOPWARE_MCP_ALLOW_WRITE=true. Every write operation is shown as a dry run first; the real change requires confirmation. A write budget caps the number of operations per process.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open