# Shopify Store Sync

Shopify Store Sync is a Claude Code MCP server that compares Shopify stores and prepares changes for controlled synchronization.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: ussefidder
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ussefidder/shopify-store-sync-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shopify-store-sync

## What it does

Shopify Store Sync inspects two Shopify stores, reports field-level differences, and creates a plan before any changes are applied. References between products, pages, and collections are matched through handles, while the server leaves deletions out of the sync.

It covers store configuration, metaobjects, pages, menus, redirects, collections, policies, files, and images. Products, metafield values, translations, and discounts are opt-in resources; discounts are compared but never written. New products are created as drafts. Node.js `22` or later is required, with `SHOPIFY_STORES_FILE` and `SYNC_SNAPSHOT_DIR` available for configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHOPIFY_STORES_FILE`, `SYNC_SNAPSHOT_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHOPIFY_STORES_FILE=<SHOPIFY_STORES_FILE> --env SYNC_SNAPSHOT_DIR=<SYNC_SNAPSHOT_DIR> --transport stdio shopify-store-sync -- npx -y shopify-store-sync-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add shopify-store-sync --env SHOPIFY_STORES_FILE=<SHOPIFY_STORES_FILE> --env SYNC_SNAPSHOT_DIR=<SYNC_SNAPSHOT_DIR> -- npx -y shopify-store-sync-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shopify-store-sync": {
            "command": "npx",
            "args": [
                "-y",
                "shopify-store-sync-mcp"
            ],
            "env": {
                "SHOPIFY_STORES_FILE": "<SHOPIFY_STORES_FILE>",
                "SYNC_SNAPSHOT_DIR": "<SYNC_SNAPSHOT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shopify-store-sync": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "shopify-store-sync-mcp"
            ],
            "env": {
                "SHOPIFY_STORES_FILE": "<SHOPIFY_STORES_FILE>",
                "SYNC_SNAPSHOT_DIR": "<SYNC_SNAPSHOT_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHOPIFY_STORES_FILE=<SHOPIFY_STORES_FILE> -e SYNC_SNAPSHOT_DIR=<SYNC_SNAPSHOT_DIR> shopify-store-sync npx -y shopify-store-sync-mcp
```
Replace <…> with your own values

## When to use it
- compare a development store with production field by field
- review a synchronization plan before applying changes
- carry product, page, and collection references across stores
- match files and images by filename
- match product variants by option values

## Example prompts
- Compare the development store with production and show every field-level difference.
- Create a dry-run plan for pages, menus, and collections without applying it.
- Prepare a product sync plan with related images, then apply it after confirmation.

## Similar
- [shopify-multi-store](https://affpapa.org/en/nevibecode/mcp/shopify-multi-store.md) — MCP server · ★ 5 repo stars
- [shopify-app-store-review](https://affpapa.org/en/nevibecode/skills/shopify-app-store-review.md) — skill · ★ 8052 repo stars
- [shopify-webhooks](https://affpapa.org/en/nevibecode/skills/shopify-webhooks.md) — skill · 291 installs
- [shopify-use-shopify-cli](https://affpapa.org/en/nevibecode/skills/shopify-use-shopify-cli.md) — skill · 1 install
- [shopify-development](https://affpapa.org/en/nevibecode/skills/shopify-development.md) — skill · 1900 installs
- [shopify-products](https://affpapa.org/en/nevibecode/skills/shopify-products.md) — skill · 1400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
