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
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-mcpWhat 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
SW10003in a cart as customer IDa1b2c3d4and 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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> 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.