{"id":31582811,"url":"https://github.com/shopware/shopware-admin-mcp","last_synced_at":"2025-10-17T03:08:33.904Z","repository":{"id":310989118,"uuid":"1041972428","full_name":"shopware/shopware-admin-mcp","owner":"shopware","description":"This MCP server provides AI assistants with direct access to Shopware's Admin API, enabling seamless product, category, order, and theme management.","archived":false,"fork":false,"pushed_at":"2025-09-04T08:03:26.000Z","size":259,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-04T09:40:00.927Z","etag":null,"topics":["mcp-server","shopware6"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shopware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-21T09:38:03.000Z","updated_at":"2025-09-04T08:05:26.000Z","dependencies_parsed_at":"2025-09-04T09:40:03.070Z","dependency_job_id":"5dbcc2f9-8b38-4055-b25d-2588e30a32ae","html_url":"https://github.com/shopware/shopware-admin-mcp","commit_stats":null,"previous_names":["shopwarelabs/shopware-admin-mcp","shopware/shopware-admin-mcp"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/shopware/shopware-admin-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopware%2Fshopware-admin-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopware%2Fshopware-admin-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopware%2Fshopware-admin-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopware%2Fshopware-admin-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shopware","download_url":"https://codeload.github.com/shopware/shopware-admin-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shopware%2Fshopware-admin-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278532381,"owners_count":26002351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp-server","shopware6"],"created_at":"2025-10-05T23:18:22.367Z","updated_at":"2025-10-17T03:08:33.877Z","avatar_url":"https://github.com/shopware.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Shopware Admin MCP Server\n\nA Model Context Protocol (MCP) server that provides AI assistants with direct access to Shopware's Admin API for product management tasks.\n\n## Features\n\n- **Product Management**: List, search, create, and update products with media support\n- **Category Management**: List, create, update, and delete categories (supports bulk operations)\n- **Sales Channel Management**: List sales channels for product visibility\n- **Media Management**: Upload media from URLs for product images\n- **Order Management**: List and view orders\n- **Theme Management**: Change theme colors and logos\n- **Shopware Integration**: Native integration with Shopware Admin API\n\n## Available MCP Tools\n\n| Tool | Description | Parameters |\n|------|-------------|------------|\n| `product_list` | Search and paginate products | `page`, `term` (optional) |\n| `product_get` | Get detailed product information | `id` |\n| `product_create` | Create new products with pricing and media | `name`, `productNumber`, `description`, `taxRate`, `stock`, `netPrice`, `grossPrice`, `active` (optional), `visibilities` (optional), `categories` (optional), `media` (optional) |\n| `product_update` | Update existing products | `id`, `active` (optional), `name` (optional), `description` (optional), `stock` (optional), `visibilities` (optional), `categories` (optional), `media` (optional) |\n| `category_list` | List all categories | None |\n| `category_create` | Create categories (supports bulk) | `categories` (array with `name`, `parentId` optional, `active` optional) |\n| `category_update` | Update categories (supports bulk) | `categories` (array with `id`, `name` optional, `parentId` optional, `active` optional) |\n| `category_delete` | Delete categories | `ids` (array of category IDs) |\n| `sales_channel_list` | List all sales channels | None |\n| `sales_channel_update` | Update a sales channel | `id`, `active` (optional), `maintenance` (optional) |\n| `upload_media_by_url` | Upload media from URL | `url`, `fileName` |\n| `order_list` | List all orders | `page`, `filters` (optional) |\n| `order_detail` | Get detailed order information | `id` |\n| `order_update` | Update an order | `id`, `status` (optional) |\n| `theme_config_get` | Get the theme configuration for a sales channel | `salesChannelId` |\n| `theme_config_change` | Change the theme configuration for a sales channel | `salesChannelId`, `themeId`, `brandPrimaryColor` (optional), `brandSecondaryColor` (optional), `brandBackgroundColor` (optional), `logoId` (optional) |\n| `fetch_entity_list` | List all available entities in Shopware | None |\n| `fetch_single_entity_schema` | Get the schema for a single entity | `entity` |\n| `dal_aggregate` | Aggregate data from the DAL | `entity`, `type`, `field`, `filter` (optional) |\n\n## Prerequisites\n\n- Shopware 6 instance with admin access\n- Node.js 22+ for development\n\n## Installation\n\nCreate a Integration in Shopware Admin with permission to create, read, update, delete products.\n\nSet following environment variables:\n\n- `SHOPWARE_API_URL`: URL of your Shopware instance (e.g., `https://your-shopware-instance.com`)\n- `SHOPWARE_API_CLIENT_ID`: Client ID of the created integration\n- `SHOPWARE_API_CLIENT_SECRET`: Client Secret of the created integration\n\n## Usage\n\n### With Claude Code CLI\n\nAdd the server using the Claude Code CLI:\n\n```bash\nclaude mcp add shopware-admin-mcp \\\n  --env SHOPWARE_API_URL=https://your-shopware-instance.com \\\n  --env SHOPWARE_API_CLIENT_ID=your-integration-client-id \\\n  --env SHOPWARE_API_CLIENT_SECRET=your-integration-client-secret \\\n  -- npx -y @shopware-ag/admin-mcp\n```\n\nReplace the placeholder values with your actual Shopware instance URL and integration credentials.\n\n### With mcp.json\n\nAdd the following configuration to your mcp.json file:\n\n```json\n{\n  \"mcpServers\": {\n    \"shopware-admin-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@shopware-ag/admin-mcp\"],\n      \"env\": {\n        \"SHOPWARE_API_URL\": \"https://your-shopware-instance.com\",\n        \"SHOPWARE_API_CLIENT_ID\": \"your-integration-client-id\",\n        \"SHOPWARE_API_CLIENT_SECRET\": \"your-integration-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\n### Local Development\n\n```bash\n# Start local development server in stdio mode\nnpm run dev\n```\n\n### Code Quality\n\n```bash\n# Format code\nnpm run format\n\n# Fix linting issues\nnpm run lint:fix\n\n# Run type checking\nnpm run type-check\n```\n\n## Permissions\n\n| Entity                  | Read | Create | Update | Delete |\n|--------------------------|------|--------|--------|--------|\n| **Product**              | ✅   | ✅     | ✅     | ✅     |\n| Product Translation      | ✅   | ✅     | ✅     | ✅     |\n| Product Visibility       | ✅   | ✅     | ✅     | ✅     |\n| Product Category         | ✅   | ✅     | ✅     | ✅     |\n| Product Media            | ✅   | ✅     | ✅     | ✅     |\n| **Category**             | ✅   | ✅     | ✅     | ✅     |\n| Category Translation     | ✅   | ✅     | ✅     | ✅     |\n| **Sales Channel**        | ✅   | ✅     | ✅     | ✅     |\n| **Media**                | ✅   | ✅     | ✅     | ✅     |\n| Media Default Folder     | ✅   | ✅     | ✅     | ✅     |\n| Media Folder             | ✅   | ✅     | ✅     | ✅     |\n| **Tax**                  | ✅   | ✅     | ✅     | ✅     |\n| **Theme**                | ✅   | ✅     | ✅     | ✅     |\n| Theme Translation        | ✅   | ✅     | ✅     | ✅     |\n| Theme Media              | ✅   | ✅     | ✅     | ✅     |\n| Theme Sales Channel      | ✅   | ✅     | ✅     | ✅     |\n| **Order**                | ✅   | ✅     | ✅     | ✅     |\n| Order Customer           | ✅   | ✅     | ✅     | ✅     |\n| Order Delivery           | ✅   | ✅     | ✅     | ✅     |\n| Order Transaction        | ✅   | ✅     | ✅     | ✅     |\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Support\n\nFor issues and feature requests, please use the GitHub issue tracker.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshopware%2Fshopware-admin-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshopware%2Fshopware-admin-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshopware%2Fshopware-admin-mcp/lists"}