@shopware-ag/admin-mcp

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.