shopware-admin-mcp by shopware - MCP Server

Shopware Admin MCP Server

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

Tool	Description	Parameters
`product_list`	Search and paginate products	`page`, `term` (optional)
`product_get`	Get detailed product information	`id`
`product_create`	Create new products with pricing and media	`name`, `productNumber`, `description`, `taxRate`, `stock`, `netPrice`, `grossPrice`, `active` (optional), `visibilities` (optional), `categories` (optional), `media` (optional)
`product_update`	Update existing products	`id`, `active` (optional), `name` (optional), `description` (optional), `stock` (optional), `visibilities` (optional), `categories` (optional), `media` (optional)
`category_list`	List all categories	None
`category_create`	Create categories (supports bulk)	`categories` (array with `name`, `parentId` optional, `active` optional)
`category_update`	Update categories (supports bulk)	`categories` (array with `id`, `name` optional, `parentId` optional, `active` optional)
`category_delete`	Delete categories	`ids` (array of category IDs)
`sales_channel_list`	List all sales channels	None
`sales_channel_update`	Update a sales channel	`id`, `active` (optional), `maintenance` (optional)
`upload_media_by_url`	Upload media from URL	`url`, `fileName`
`order_list`	List all orders	`page`, `filters` (optional)
`order_detail`	Get detailed order information	`id`
`order_update`	Update an order	`id`, `status` (optional)
`theme_config_get`	Get the theme configuration for a sales channel	`salesChannelId`
`theme_config_change`	Change the theme configuration for a sales channel	`salesChannelId`, `themeId`, `brandPrimaryColor` (optional), `brandSecondaryColor` (optional), `brandBackgroundColor` (optional), `logoId` (optional)
`fetch_entity_list`	List all available entities in Shopware	None
`fetch_single_entity_schema`	Get the schema for a single entity	`entity`
`dal_aggregate`	Aggregate data from the DAL	`entity`, `type`, `field`, `filter` (optional)

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 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

Entity	Read	Create	Update	Delete
Product	✅	✅	✅	✅
Product Translation	✅	✅	✅	✅
Product Visibility	✅	✅	✅	✅
Product Category	✅	✅	✅	✅
Product Media	✅	✅	✅	✅
Category	✅	✅	✅	✅
Category Translation	✅	✅	✅	✅
Sales Channel	✅	✅	✅	✅
Media	✅	✅	✅	✅
Media Default Folder	✅	✅	✅	✅
Media Folder	✅	✅	✅	✅
Tax	✅	✅	✅	✅
Theme	✅	✅	✅	✅
Theme Translation	✅	✅	✅	✅
Theme Media	✅	✅	✅	✅
Theme Sales Channel	✅	✅	✅	✅
Order	✅	✅	✅	✅
Order Customer	✅	✅	✅	✅
Order Delivery	✅	✅	✅	✅
Order Transaction	✅	✅	✅	✅

License

MIT License - see LICENSE file for details.

Support

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