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-10). 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 @kisasa/shopify-mcp, not shopify-mcp-server or the unscoped shopify-mcp.
Available Tools (51)
Shared Capabilities
All list query tools (get-products, get-customers, get-orders, get-customer-orders, get-collections) 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
Field selection: fields parameter to fetch only specific fields, reducing response size
Count-only mode: countOnly parameter returns { count: N } without fetching any resource data — useful for sizing queries before paginating
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
countOnly (boolean, optional): Return only { count: N }
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"
mediaId (string, optional): Product media GID (gid://shopify/MediaImage/...) to use as the variant's image. The media must already be attached to the product (see add-product-media) and should be READY
Returns: { created, updated, userErrors }. Each variant includes inventoryPolicy, mediaId, and imageUrl. userErrors are returned (tagged operation: "create" or "update") rather than thrown, so always check them
delete-product-variants
Delete one or more variants from a product
Inputs:
productId (string, required): Shopify product GID
variantIds (array of strings, required): Variant GIDs to delete
Product Media (2 tools)
add-product-media
Attach images to an existing product by public URL (uses productUpdate with media; productCreateMedia is deprecated)
Inputs:
productId (string, required): Shopify product GID
media (array, required): Images to attach, each { originalSource, alt? }. originalSource must be a publicly accessible URL that Shopify can download
Returns: { productId, media, userErrors }, where each new media item has id, status, alt, imageUrl, and mediaErrors
Shopify processes media asynchronously. New items usually start as UPLOADED or PROCESSING with imageUrl: null; use get-product-media to confirm they reach READY
get-product-media
List a product's media with processing status
Inputs:
productId (string, required): Shopify product GID
Returns: each item's id, status (UPLOADED / PROCESSING / READY / FAILED), mediaContentType, alt, imageUrl, and mediaErrors (explains a FAILED status)
Example: give a variant its own image
add-product-media with the image URL
get-product-media until the new item is READY, and copy its id
manage-product-variants with { id: "<variant GID>", mediaId: "<media GID>" }
Sales Channel Publishing (4 tools)
These tools work with sales channels (publications with an app catalog, such as Online Store and Point of Sale). Market and B2B catalogs are not included. Requires the read_publications and write_publications scopes.
get-publications
List the store's sales channels
Inputs: none
Returns: each channel's id, name (e.g. "Online Store"), handle (e.g. "online_store"), autoPublish, and supportsFuturePublishing
get-product-publications
Show whether a product is published on each sales channel
Inputs:
productId (string, required): Shopify product GID
Returns: { productId, title, publications }, with publicationId, name, published, and publishDate for every channel
publish-product
Publish a product to one or more sales channels (uses publishablePublish)
Inputs:
productId (string, required): Shopify product GID
publicationIds (array of strings, optional): Publication GIDs from get-publications
publicationNames (array of strings, optional): Channel names exactly as returned by get-publications, e.g. ["Online Store", "Point of Sale"]
Provide exactly one of publicationIds or publicationNames. A name that matches no channel, or more than one, is rejected before anything changes
Returns: the product's state on every channel afterwards, plus userErrors
unpublish-product
Unpublish a product from one or more sales channels (uses publishableUnpublish)
Inputs: same as publish-product
Returns: the product's state on every channel afterwards, plus userErrors
Customer Management (8 tools)
get-customers
List customers with search, pagination, and sorting
Get metafields for any Shopify resource (products, orders, customers, variants, collections, etc.)
Inputs:
ownerId (string, required): GID of any resource
namespace (string, optional): Filter by namespace
first (number, default: 25): Number of metafields to return
after (string, optional): Pagination cursor
set-metafields
Set metafields on any Shopify resource. Creates or updates up to 25 metafields atomically
Inputs:
metafields (array, required): Metafields to set, each with ownerId, key, value, and optional namespace, type
delete-metafields
Delete metafields from any Shopify resource
Inputs:
metafields (array, required): Metafields to delete, each with ownerId, namespace, key
Inventory Management (1 tool)
inventory-set-quantities
Set absolute inventory quantities for items at specific locations
Inputs:
reason (string, required): Reason for change (e.g. "correction", "cycle_count_available")
name (string, required): "available" or "on_hand"
quantities (array, required): Items with inventoryItemId, locationId, quantity, and optional changeFromQuantity
changeFromQuantity (integer or null, optional): The quantity you expect is currently stored. Shopify only applies the change if it still matches, and otherwise returns a CHANGE_FROM_QUANTITY_STALE error. Omit it (or pass null) to set the quantity without this check
idempotencyKey (string, optional): Idempotency key for the request, which Admin API 2026-04 and later require. If omitted, a new UUID is generated for each call. Reuse a key only to retry the exact same request
Returns: { idempotencyKey, adjustmentGroup, userErrors }. userErrors include a code (e.g. CHANGE_FROM_QUANTITY_STALE, IDEMPOTENCY_KEY_PARAMETER_MISMATCH) and are returned rather than thrown, so always check them
Tag Management (2 tools)
manage-tags
Add or remove tags on any taggable resource (orders, products, customers, draft orders, articles)
Inputs:
id (string, required): GID of the resource (e.g. gid://shopify/Product/123)
tags (array of strings, required): Tags to add or remove
action (string, required): "add" or "remove"
manage-tags-bulk
Bulk add or remove tags on up to 100 resources in a single call (runs mutations in parallel)
Inputs:
ids (array of strings, required): Resource GIDs (up to 100). For larger sets, call multiple times
tags (array of strings, required): Tags to add or remove
action (string, required): "add" or "remove"
Collection Management (2 tools)
get-collections
List collections with search, pagination, and sorting
Inputs:
query (string, optional): Shopify query syntax
limit (number, default: 10): Maximum collections to return
sortKey, reverse, after/before: Standard pagination and sorting
fields, countOnly: Standard field selection and count-only mode
get-collection-by-id
Get a single collection with full details including products, rules (smart collections), SEO, and image
Inputs:
collectionId (string, required): Collection ID (e.g. gid://shopify/Collection/123 or just 123)
productsFirst (number, default: 25): Number of products to include (0 to skip)
"Access denied for … field": the app is missing a scope. See the scope table under Authentication, then release a new app version, approve it on the store, and restart the server.
Tools don't appear: fully quit and restart Claude Desktop after editing its config.
Releasing
Releases are published automatically by .github/workflows/publish.yml when a version bump reaches main:
In your PR, bump version in package.json and both version fields in server.json (they must match, or the workflow fails).
Merge to main. The workflow publishes to npm (with provenance), publishes to the MCP Registry, and creates a vX.Y.Z GitHub release.
Merges that don't change the version publish nothing.