Skillget

shopware-admin-mcp

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 33 GitHub stars
Code Warn
  • process.env — Environment variable access in src/index.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

This MCP server provides AI assistants with direct access to Shopware's Admin API, enabling seamless product, category, order, and theme management.

README.md

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

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

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.

Reviews (0)

No results found