Shopify Store Sync — Claude Code MCP server: install
Shopify Store Sync is a Claude Code MCP server that compares Shopify stores and prepares changes for controlled synchronization.
MIT ★ 7 updated 2026-11-16
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-mcpWhat Shopify Store Sync 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.
What it helps with
- 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 for the agent
- 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.
How to install Shopify Store Sync
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shopify Store Sync
How do I install Shopify Store Sync in Claude Code?
Run claude mcp add shopify-store-sync-mcp -- npx -y shopify-store-sync-mcp. This registers the server through npx.
What does Shopify Store Sync do?
It compares Shopify stores, produces a dry-run plan, and transfers selected data after confirmation. Cross-resource references are remapped by handle, and deletions are never performed.
What does Shopify Store Sync require?
It requires Node.js 22 or later. Configuration uses SHOPIFY_STORES_FILE and SYNC_SNAPSHOT_DIR.