Shopware MCP
Query and audit a Shopware 6 shop, with a read-only default and dry-run writes
- 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-mcpAdd 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.comRequiredSHOPWARE_CLIENT_IDIntegration access key IDRequiredSHOPWARE_CLIENT_SECRETIntegration secret access keyRequiredSHOPWARE_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.
