Shopware Admin MCP Server

[!WARNING] This repository is deprecated, archived, and read-only.

This project is no longer actively maintained. The repository has been archived and is kept available for historical reference only.

We are no longer accepting issues, pull requests, feature requests, bug reports, or maintenance updates in this repository. No further releases are planned.

A Model Context Protocol (MCP) server that provides AI assistants with direct access to Shopware's Admin API for product management tasks.

Features

• Product Management: List, search, create, and update products with media support
• Category Management: List, create, update, and delete categories (supports bulk operations)
• Sales Channel Management: List sales channels for product visibility
• Media Management: Upload media from URLs for product images
• Order Management: List and view orders
• Theme Management: Change theme colors and logos
• Shopware Integration: Native integration with Shopware Admin API

Available MCP Tools

Prerequisites

• Shopware 6 instance with admin access
• Node.js 22+ for development

Installation

Create a Integration in Shopware Admin with permission to create, read, update, delete products.

Set following environment variables:

• SHOPWARE_API_URL: URL of your Shopware instance (e.g., https://your-shopware-instance.com)
• SHOPWARE_API_CLIENT_ID: Client ID of the created integration
• SHOPWARE_API_CLIENT_SECRET: Client Secret of the created integration

Usage

With Claude Code CLI

Add the server using the Claude Code CLI:

claude mcp add shopware-admin-mcp \
  --env SHOPWARE_API_URL=https://your-shopware-instance.com \
  --env SHOPWARE_API_CLIENT_ID=your-integration-client-id \
  --env SHOPWARE_API_CLIENT_SECRET=your-integration-client-secret \
  -- npx -y @shopware-ag/admin-mcp

Replace the placeholder values with your actual Shopware instance URL and integration credentials.

With mcp.json

Add the following configuration to your mcp.json file:

{
  "mcpServers": {
    "shopware-admin-mcp": {
      "command": "npx",
      "args": ["-y", "@shopware-ag/admin-mcp"],
      "env": {
        "SHOPWARE_API_URL": "https://your-shopware-instance.com",
        "SHOPWARE_API_CLIENT_ID": "your-integration-client-id",
        "SHOPWARE_API_CLIENT_SECRET": "your-integration-client-secret"
      }
    }
  }
}

Development

Local Development

# Start local development server in stdio mode
npm run dev

Code Quality

# Format code
npm run format

# Fix linting issues
npm run lint:fix

# Run type checking
npm run type-check

Permissions

License

MIT License - see LICENSE file for details.

Support

For issues and feature requests, please use the GitHub issue tracker.