MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.
--apiVersion: Specify the Shopify API version (default: 2026-01). Can also be set via SHOPIFY_API_VERSION environment variable.
⚠️ Important: If you see errors about "SHOPIFY_ACCESS_TOKEN environment variable is required" when using command-line arguments, you might have a different package installed. Make sure you're using shopify-mcp, not shopify-mcp-server.
Available Tools (31)
Pagination, Sorting & Filtering
All list query tools (get-products, get-customers, get-orders, get-customer-orders) support:
Cursor-based pagination: after / before (cursor strings), with pageInfo in the response (hasNextPage, hasPreviousPage, startCursor, endCursor)
Sorting: sortKey (enum specific to each resource) and reverse (boolean)
Advanced filtering: query or searchQuery parameter accepting Shopify query syntax
Product Management (8 tools)
get-products
Get all products or search by title with pagination and sorting
Inputs:
searchTitle (string, optional): Filter products by title (wraps in title:*...*)
limit (number, default: 10): Maximum number of products to return
sortKey (string, optional): One of CREATED_AT, ID, INVENTORY_TOTAL, PRODUCT_TYPE, PUBLISHED_AT, RELEVANCE, TITLE, UPDATED_AT, VENDOR
reverse (boolean, optional): Reverse the sort order
after / before (string, optional): Pagination cursors
get-product-by-id
Get a specific product by ID with full details including SEO, options, media, variants, and collections
Inputs:
productId (string, required): Shopify product GID
Returns: productType, descriptionHtml, seo, options (with optionValues), media (images), variants, collections, tags, vendor, price range, inventory
create-product
Create a new product. When using productOptions, Shopify registers all option values but only creates one default variant (first value of each option, price $0). Use manage-product-variants with strategy: REMOVE_STANDALONE_VARIANT afterward to create all real variants with prices.
Inputs:
title (string, required): Title of the product
descriptionHtml (string, optional): Description with HTML
handle (string, optional): URL slug. Auto-generated from title if omitted
vendor (string, optional): Vendor of the product
productType (string, optional): Type of the product
tags (array of strings, optional): Product tags
status (string, optional): "ACTIVE", "DRAFT", or "ARCHIVED". Default "DRAFT"
seo (object, optional): { title, description } for search engines
productOptions (array of objects, optional): Options to create inline, e.g. [{ name: "Size", values: [{ name: "S" }, { name: "M" }] }]. Max 3 options.
collectionsToJoin (array of strings, optional): Collection GIDs to add the product to
update-product
Update an existing product's fields
Inputs:
id (string, required): Shopify product GID
title (string, optional): New title
descriptionHtml (string, optional): New description
handle (string, optional): New URL slug
vendor (string, optional): New vendor
productType (string, optional): New product type
tags (array of strings, optional): New tags (overwrites existing)
status (string, optional): "ACTIVE", "DRAFT", or "ARCHIVED"
seo (object, optional): { title, description } for search engines
metafields (array of objects, optional): Metafields to set or update
collectionsToJoin (array of strings, optional): Collection GIDs to add the product to
collectionsToLeave (array of strings, optional): Collection GIDs to remove the product from
redirectNewHandle (boolean, optional): If true, old handle redirects to new handle
delete-product
Delete a product
Inputs:
id (string, required): Shopify product GID
manage-product-options
Create, update, or delete product options (e.g. Size, Color)
Inputs:
productId (string, required): Shopify product GID
action (string, required): "create", "update", or "delete"
variantStrategy (string, optional): "LEAVE_AS_IS" (default) or "CREATE" — controls whether new variant combinations are generated when adding options
For action: "create":
options (array, required): Options to create, e.g. [{ name: "Size", values: ["S", "M", "L"] }]
For action: "update":
optionId (string, required): Option GID to update
name (string, optional): New name for the option
position (number, optional): New position
valuesToAdd (array of strings, optional): Values to add
valuesToDelete (array of strings, optional): Value GIDs to remove
For action: "delete":
optionIds (array of strings, required): Option GIDs to delete
manage-product-variants
Create or update product variants in bulk
Inputs:
productId (string, required): Shopify product GID
strategy (string, optional): How to handle the default variant when creating. "DEFAULT" (removes "Default Title" automatically), "REMOVE_STANDALONE_VARIANT" (recommended for full control), or "PRESERVE_STANDALONE_VARIANT"
variants (array, required): Variants to create or update. Each variant:
id (string, optional): Variant GID for updates. Omit to create new
price (string, optional): Price, e.g. "49.00"
compareAtPrice (string, optional): Compare-at price for showing discounts
sku (string, optional): SKU (mapped to inventoryItem.sku)
tracked (boolean, optional): Whether inventory is tracked. Set false for print-on-demand
taxable (boolean, optional): Whether the variant is taxable
barcode (string, optional): Barcode
weight (number, optional): Weight of the variant
weightUnit (string, optional): "GRAMS", "KILOGRAMS", "OUNCES", or "POUNDS"