miller-joe avatar

Shopify Mcp

miller-joe/shopify-mcp

Connects Claude to the Shopify Admin GraphQL API with full product, order, inventory, customer, webhook, metafield, and fulfillment tooling. The ComfyUI bridge is the standout: prompt Claude to generate product images on the fly and auto-attach them during product creation, so "create a cosmic candle product with AI art" completes end to end. Supports both stdio and streamable HTTP transports. Includes draft orders, metaobjects, variant bulk ops, and webhook management. Requires a Shopify admin access token; custom app tokens work for existing dev stores, though newer apps need the token exchange flow. Pair it with the comfyui-mcp server to unlock the generative workflow.

tools
36
auth
Secret needed
transport
HTTP
env vars
6
last updated
Apr 20, 2026

Tools

36 tools

Public tool metadata for what this MCP can expose to an agent.

SHOPIFY_ADD_PRODUCT_TO_COLLECTIONAdds a product to an existing *custom collection*, optionally specifying its `position` if the collection is manually sorted.3 params

Adds a product to an existing *custom collection*, optionally specifying its `position` if the collection is manually sorted.

Parameters* required
collection_idinteger
Identifier of the *custom collection*.
positioninteger
Optional 1-based position if the custom collection is manually sorted; product is added to the end if unspecified or collection isn't manually sorted.
product_idinteger
Identifier of the product to add.
SHOPIFY_COUNT_PRODUCT_IMAGESRetrieves the total count of images for a Shopify product, useful for inventory management or display logic; the provided `product_id` must exist in the store.1 params

Retrieves the total count of images for a Shopify product, useful for inventory management or display logic; the provided `product_id` must exist in the store.

Parameters* required
product_idstring
The unique identifier for the Shopify product whose images are to be counted.
SHOPIFY_CREATE_CUSTOM_COLLECTIONCreates a new custom collection in a Shopify store, requiring a unique title for manually curated product groupings (e.g., 'New Arrivals', 'Seasonal Specials').1 params

Creates a new custom collection in a Shopify store, requiring a unique title for manually curated product groupings (e.g., 'New Arrivals', 'Seasonal Specials').

Parameters* required
titlestring
Unique title for the custom collection, visible to customers and used for product organization.
SHOPIFY_CREATE_CUSTOMERTool to create a new customer in Shopify. Use when you need to add a new customer record to the store.12 params

Tool to create a new customer in Shopify. Use when you need to add a new customer record to the store.

Parameters* required
addressesarray
A list of addresses for the customer.
emailstring
The customer's unique email address.
first_namestring
The customer's first name.
last_namestring
The customer's last name.
notestring
An optional note about the customer.
passwordstring
The customer's password. If provided, password_confirmation is also required.
password_confirmationstring
Confirmation of the customer's password. Required if password is provided.
phonestring
The customer's phone number (E.164 format recommended).
send_email_inviteboolean
If true, sends the customer an email invite to create an account.
send_email_welcomeboolean
Whether to send the customer a welcome email. Defaults to true. If send_email_invite is true, this can be set to false.default: true
tagsstring
A comma-separated string of tags to associate with the customer.
verified_emailboolean
Whether the customer has verified their email address.
SHOPIFY_CREATE_ORDERCreates a new order in Shopify, typically requiring line items; if `customer_id` is provided, it must correspond to an existing customer.5 params

Creates a new order in Shopify, typically requiring line items; if `customer_id` is provided, it must correspond to an existing customer.

Parameters* required
currencystring
The three-letter ISO 4217 currency code for the amounts in the order (e.g., USD, CAD, EUR).
customer_idstring
The unique identifier of the customer associated with this order. If provided, the order will be linked to this customer. This field is optional.
line_itemsarray
A list of line item objects, each representing an item in the order. Each object should specify at least a `variant_id` (or `product_id`) and `quantity`. Other common fields include `price` and `ti...
total_taxnumber
The total amount of tax for the order. This should be a numeric value representing the sum of all taxes.
transactionsarray
A list of transaction objects associated with the order, typically representing payment information. Each object usually includes `kind` (e.g., 'sale', 'authorization'), `amount`, `status`, and `ga...
SHOPIFY_CREATE_PRODUCTCreates a new product in a Shopify store; a product title is generally required.5 params

Creates a new product in a Shopify store; a product title is generally required.

Parameters* required
body_htmlstring
A detailed description of the product, which can include HTML formatting for rich text.
product_typestring
A category for the product, used for filtering and organizing products in Shopify.
titlestring
The title of the product, typically required by Shopify.
variantsarray
Product variants. Common keys include 'price', 'sku', 'option1', 'option2', 'inventory_quantity'. At least one variant is typically required; if not provided, Shopify might create a default one.
vendorstring
The name of the product's vendor or manufacturer.
SHOPIFY_CREATE_PRODUCT_IMAGETool to create a new product image for a given product. Use when you need to add an image to a product by providing the image source URL or attachment.2 params

Tool to create a new product image for a given product. Use when you need to add an image to a product by providing the image source URL or attachment.

Parameters* required
imageobject
An object containing the image details.
product_idstring
The ID of the product to associate the image with.
SHOPIFY_CREATE_PRODUCT_METAFIELDCreates a new metafield for a specific Shopify product.6 params

Creates a new metafield for a specific Shopify product.

Parameters* required
descriptionstring
A description of the information that the metafield contains.
keystring
The key for the metafield. Must be at least 3 characters long.
namespacestring
The namespace for the metafield. Must be at least 3 characters long.
product_idstring
The unique identifier of the Shopify product to add a metafield to.
typestring
The value type of the metafield. Defaults to single_line_text_field.default: single_line_text_field
valuestring
The value for the metafield.
SHOPIFY_DELETE_CUSTOM_COLLECTIONPermanently deletes a custom collection from a Shopify store using its `collection_id`; this action is irreversible and requires a valid, existing `collection_id`.1 params

Permanently deletes a custom collection from a Shopify store using its `collection_id`; this action is irreversible and requires a valid, existing `collection_id`.

Parameters* required
collection_idstring
The unique identifier for the custom collection that needs to be deleted. This ID is a numerical string assigned by Shopify when the collection is created.
SHOPIFY_DELETE_PRODUCTDeletes a specific, existing product from a Shopify store using its unique product ID; this action is irreversible.1 params

Deletes a specific, existing product from a Shopify store using its unique product ID; this action is irreversible.

Parameters* required
idstring
The unique identifier of the Shopify product to be deleted. This ID is essential for targeting the correct product for removal.
SHOPIFY_DELETE_PRODUCT_IMAGEDeletes a specific image from a product in Shopify, requiring the `product_id` of an existing product and the `image_id` of an image currently associated with that product.2 params

Deletes a specific image from a product in Shopify, requiring the `product_id` of an existing product and the `image_id` of an image currently associated with that product.

Parameters* required
image_idstring
The unique identifier of the specific product image to be deleted.
product_idstring
The unique identifier of the product from which the image is to be deleted.
SHOPIFY_DELETE_PRODUCT_METAFIELDDeletes a specific metafield from a Shopify product using the product ID and metafield ID.2 params

Deletes a specific metafield from a Shopify product using the product ID and metafield ID.

Parameters* required
metafield_idstring
The unique identifier of the metafield to delete.
product_idstring
The unique identifier of the Shopify product.
SHOPIFY_GET_ALL_CUSTOMERSRetrieves customer records from a Shopify store, with options for filtering, selecting specific fields, and paginating through the results.8 params

Retrieves customer records from a Shopify store, with options for filtering, selecting specific fields, and paginating through the results.

Parameters* required
created_at_maxstring
Filter customers created before or on this date. Format: YYYY-MM-DD or ISO 8601 datetime string (e.g., '2023-10-26T10:00:00-05:00').default:
created_at_minstring
Filter customers created after or on this date. Format: YYYY-MM-DD or ISO 8601 datetime string (e.g., '2023-10-26T10:00:00-05:00').default:
fieldsstring
A comma-separated list of customer fields to include in the response (e.g., 'id,email,first_name'). By default, all fields are returned.default:
idsarray
A list of specific customer IDs to retrieve. If empty, all customers (matching other filters) will be retrieved.
limitinteger
The maximum number of customers to retrieve. Defaults to 50, with a maximum value of 250.default: 50
since_idstring
Retrieve only customers with an ID greater than this specified ID. This is used for paginating through results.default:
updated_at_maxstring
Filter customers last updated before or on this date. Format: YYYY-MM-DD or ISO 8601 datetime string.default:
updated_at_minstring
Filter customers last updated after or on this date. Format: YYYY-MM-DD or ISO 8601 datetime string.default:
SHOPIFY_GET_COLLECTION_BY_IDRetrieves a specific Shopify collection by its `collection_id`, optionally filtering returned data to specified `fields`.2 params

Retrieves a specific Shopify collection by its `collection_id`, optionally filtering returned data to specified `fields`.

Parameters* required
collection_idstring
The unique identifier of the Shopify collection to retrieve.
fieldsstring
Comma-separated list of fields to retrieve; if omitted, all fields are returned. E.g., 'id,title,handle'.
SHOPIFY_GET_COLLECTSRetrieves a list of collects from a Shopify store, where a collect links a product to a custom collection.3 params

Retrieves a list of collects from a Shopify store, where a collect links a product to a custom collection.

Parameters* required
fieldsstring
Comma-separated list of fields to retrieve (e.g., `id,collection_id,product_id`); if unspecified, all fields are returned.
limitinteger
Maximum number of collects to retrieve (1-250).default: 50
since_idinteger
Retrieve only collects created after this ID, for pagination.
SHOPIFY_GET_COLLECTS_COUNTRetrieves the total count of collects (product-to-collection associations) in a Shopify store.

Retrieves the total count of collects (product-to-collection associations) in a Shopify store.

No parameter schema in public metadata yet.

SHOPIFY_GET_CUSTOM_COLLECTIONSRetrieves a list of custom collections from a Shopify store, optionally filtered by IDs, product ID, or handle.4 params

Retrieves a list of custom collections from a Shopify store, optionally filtered by IDs, product ID, or handle.

Parameters* required
handlestring
Filter results by the custom collection's unique, human-readable string identifier (e.g., 'summer-specials').
idsstring
A comma-separated string of custom collection IDs to retrieve.
limitinteger
The maximum number of custom collections to return (between 1 and 250).default: 50
product_idinteger
Filter results to custom collections that contain a specific product ID.
SHOPIFY_GET_CUSTOM_COLLECTIONS_COUNTRetrieves the total number of custom collections in a Shopify store.

Retrieves the total number of custom collections in a Shopify store.

No parameter schema in public metadata yet.

SHOPIFY_GET_CUSTOMERRetrieves detailed information for a specific customer from a Shopify store, provided their valid and existing `customer_id`.1 params

Retrieves detailed information for a specific customer from a Shopify store, provided their valid and existing `customer_id`.

Parameters* required
customer_idstring
The unique identifier for the customer in Shopify.
SHOPIFY_GET_CUSTOMER_ORDERSRetrieves all orders for a specific, existing customer in Shopify using their unique customer ID.1 params

Retrieves all orders for a specific, existing customer in Shopify using their unique customer ID.

Parameters* required
customer_idstring
Unique identifier for the customer whose orders are to be retrieved.
SHOPIFY_GET_ORDER_LISTRetrieves a list of orders from Shopify with optional filters and pagination.16 params

Retrieves a list of orders from Shopify with optional filters and pagination.

Parameters* required
attribution_app_idstring
Show orders attributed to a specific app ID. Use 'current' to show orders for the calling app.
created_at_maxstring
Show orders created at or before this ISO 8601 timestamp (for example, 2024-12-31T23:59:59Z).
created_at_minstring
Show orders created at or after this ISO 8601 timestamp (for example, 2024-01-01T00:00:00Z).
fieldsstring
Comma-separated list of fields to include in the response. You may provide a list; it will be converted to a comma-separated string.
financial_statusstring
Filter by financial status. Valid values: authorized, pending, paid, partially_paid, refunded, voided, partially_refunded, any, unpaid.
fulfillment_statusstring
Filter by fulfillment status. Valid values: shipped, partial, unshipped, any, unfulfilled.
idsstring
Comma-separated list of order IDs to return. You may provide a list of integers; it will be converted to a comma-separated string.
limitinteger
Maximum number of results per page (default 50, maximum 250).
namestring
Filter orders by name (for example, #1001).
page_infostring
Cursor for pagination. When using page_info for cursor pagination, only limit may accompany it.
processed_at_maxstring
Show orders imported at or before this ISO 8601 timestamp.
processed_at_minstring
Show orders imported at or after this ISO 8601 timestamp.
since_idinteger
Return orders with IDs greater than this ID.
statusstring
Filter by order status. Valid values: open, closed, cancelled, any.
updated_at_maxstring
Show orders last updated at or before this ISO 8601 timestamp.
updated_at_minstring
Show orders last updated at or after this ISO 8601 timestamp.
SHOPIFY_GET_ORDERSBY_IDRetrieves a specific Shopify order by its unique ID, which must correspond to an existing order.2 params

Retrieves a specific Shopify order by its unique ID, which must correspond to an existing order.

Parameters* required
fieldsstring
Comma-separated list of fields to include in the response (e.g., 'id,line_items').
order_idstring
The unique identifier of the Shopify order to retrieve.
SHOPIFY_GET_ORDERS_WITH_FILTERSRetrieves Shopify orders filtered by dates and other filters. Uses server-side filtering.16 params

Retrieves Shopify orders filtered by dates and other filters. Uses server-side filtering.

Parameters* required
attribution_app_idstring
Filter to orders attributed to a given app ID; use 'current' to show orders for the calling app.
created_at_maxstring
Show orders created at or before this ISO 8601 timestamp.
created_at_minstring
Show orders created at or after this ISO 8601 timestamp.
fieldsstring
Comma-separated list of order fields to include in the response.
financial_statusstring
Filter by financial status (authorized,pending,paid,partially_paid,refunded,voided,partially_refunded,any,unpaid).
fulfillment_statusstring
Filter by fulfillment status (shipped/fulfilled,partial,unshipped/null,any,unfulfilled).
idsstring
Comma-separated list of numeric order IDs to retrieve.
limitinteger
Maximum number of orders to return per page (1-250).
namestring
Filter by order name (e.g., #1001).
page_infostring
A cursor for use in pagination. When present, only limit (and fields where supported) should accompany this parameter.
processed_at_maxstring
Show orders imported/processed at or before this ISO 8601 timestamp.
processed_at_minstring
Show orders imported/processed at or after this ISO 8601 timestamp.
since_idinteger
Restrict results to after the specified ID.
statusstring
Filter by order status (open,closed,cancelled,any).
updated_at_maxstring
Show orders last updated at or before this ISO 8601 timestamp.
updated_at_minstring
Show orders last updated at or after this ISO 8601 timestamp.
SHOPIFY_GET_PRODUCTRetrieves details for an existing Shopify product using its unique product ID.1 params

Retrieves details for an existing Shopify product using its unique product ID.

Parameters* required
product_idstring
The unique identifier of the Shopify product to be retrieved.
SHOPIFY_GET_PRODUCT_IMAGERetrieves detailed information for a specific product image, identified by its ID and its associated product ID, from a Shopify store.2 params

Retrieves detailed information for a specific product image, identified by its ID and its associated product ID, from a Shopify store.

Parameters* required
image_idstring
The unique numerical identifier of the image associated with the product.
product_idstring
The unique numerical identifier of the Shopify product.
SHOPIFY_GET_PRODUCT_IMAGESRetrieves all images for a Shopify product, specified by its `product_id` which must correspond to an existing product.3 params

Retrieves all images for a Shopify product, specified by its `product_id` which must correspond to an existing product.

Parameters* required
fieldsstring
A comma-separated list of fields to include in the response. Available fields include: id, product_id, position, created_at, updated_at, alt, width, height, src.
product_idstring
The unique identifier of the Shopify product for which to retrieve images.
since_idstring
Restricts the results to product images created after the specified image ID. Useful for pagination.
SHOPIFY_GET_PRODUCT_METAFIELDRetrieves a specific metafield for a Shopify product using the product ID and metafield ID.2 params

Retrieves a specific metafield for a Shopify product using the product ID and metafield ID.

Parameters* required
metafield_idstring
The unique identifier of the metafield to retrieve.
product_idstring
The unique identifier of the Shopify product.
SHOPIFY_GET_PRODUCT_METAFIELDSRetrieves all metafields for a specific Shopify product. Metafields can be filtered by namespace and/or key.3 params

Retrieves all metafields for a specific Shopify product. Metafields can be filtered by namespace and/or key.

Parameters* required
keystring
Filter metafields by key. If omitted, returns all metafields (or all within namespace if specified).
namespacestring
Filter metafields by namespace. If omitted, returns all metafields.
product_idstring
The unique identifier of the Shopify product to retrieve metafields for.
SHOPIFY_GET_PRODUCTSRetrieves a list of products from a Shopify store.1 params

Retrieves a list of products from a Shopify store.

Parameters* required
idsstring
A comma-separated string of product IDs to retrieve. If this field is not provided (i.e., defaults to `None`), all products will be fetched.
SHOPIFY_GET_PRODUCTS_COUNTRetrieves the total, unfiltered count of all products in a Shopify store.

Retrieves the total, unfiltered count of all products in a Shopify store.

No parameter schema in public metadata yet.

SHOPIFY_GET_PRODUCTS_IN_COLLECTIONRetrieves all products within a specified Shopify collection, requiring a valid `collection_id`.2 params

Retrieves all products within a specified Shopify collection, requiring a valid `collection_id`.

Parameters* required
collection_idstring
Identifier for the Shopify collection. Often found in the collection's Shopify admin URL.
limitinteger
Maximum number of products to retrieve.default: 50
SHOPIFY_GET_PRODUCTS_PAGINATEDTool to list products with Shopify cursor-based pagination. Use when iterating over large product catalogs via the Link header.3 params

Tool to list products with Shopify cursor-based pagination. Use when iterating over large product catalogs via the Link header.

Parameters* required
fieldsstring
Comma-separated list of product fields to include in the response.
limitinteger
Number of products per page. Defaults to 50; maximum 250.default: 50
page_infostring
Cursor token for next or previous page. Use the token value from the Link header.
SHOPIFY_GET_SHOP_DETAILSRetrieves comprehensive administrative information about the authenticated Shopify store, as defined by the Shopify API.

Retrieves comprehensive administrative information about the authenticated Shopify store, as defined by the Shopify API.

No parameter schema in public metadata yet.

SHOPIFY_GRAPH_QL_QUERYExecutes a GraphQL query against the Shopify Admin API. This allows for flexible data retrieval and mutations including metafields operations.2 params

Executes a GraphQL query against the Shopify Admin API. This allows for flexible data retrieval and mutations including metafields operations.

Parameters* required
querystring
The GraphQL query string to execute against the Shopify Admin API.
variablesobject
Variables to be used in the GraphQL query as a dictionary.
SHOPIFY_UPDATE_ORDERUpdates the phone number for an existing Shopify order, identified by its ID; pass `phone=None` to remove the current phone number.2 params

Updates the phone number for an existing Shopify order, identified by its ID; pass `phone=None` to remove the current phone number.

Parameters* required
idinteger
The unique identifier of the Shopify order whose phone number is to be updated.
phonestring
The new phone number for the order. E.164 format (e.g., '+15551234567') is recommended for international numbers. An empty string `''` may also be used to clear it, depending on Shopify API behavior.
SHOPIFY_UPDATE_PRODUCT_METAFIELDUpdates an existing metafield for a specific Shopify product.5 params

Updates an existing metafield for a specific Shopify product.

Parameters* required
descriptionstring
A new description of the information that the metafield contains. If not provided, the existing description will be kept.
metafield_idstring
The unique identifier of the metafield to update.
product_idstring
The unique identifier of the Shopify product.
typestring
The new value type of the metafield. If not provided, the existing type will be kept.
valuestring
The new value for the metafield. If not provided, the existing value will be kept.

Sponsors

Configuration

SHOPIFY_STORE*

Store domain, e.g. 'my-store' or 'my-store.myshopify.com'

SHOPIFY_ACCESS_TOKEN*secret

Admin API access token (shpat_...). See README for how to create a custom app on a dev store.

SHOPIFY_API_VERSION

Shopify GraphQL Admin API version (default: 2026-04)

COMFYUI_URL

ComfyUI HTTP URL for bridge tools. When unset, generate_* bridge tools are disabled.

COMFYUI_PUBLIC_URL

Externally-reachable ComfyUI URL (defaults to COMFYUI_URL)

COMFYUI_DEFAULT_CKPT

Default ComfyUI checkpoint filename for bridge tools (default: sd_xl_base_1.0.safetensors)

Readme

shopify-mcp

MCP server for Shopify. Full Admin GraphQL API tooling plus an AI-driven product creation bridge via ComfyUI image generation.

shopify-mcp MCP server

GitHub Sponsors Ko-fi

The pitch

Every other Shopify MCP is a plain Admin API wrapper. This one pairs with @miller-joe/comfyui-mcp so you can say things like:

"Create a product called 'Nebula Dreamer'. Generate a cosmic abstract image for it, description matching the vibe, tagged astrology, status draft."

Claude then runs ComfyUI, gets an image back, creates the Shopify product, and attaches the image, all in one call.

Install


View the full README on GitHub

Details

Repository
github.com/miller-joe/shopify-mcp
Category
Finance & Commerce
Package
@miller-joe/shopify-mcp
Transport
HTTP
Auth
Required
Registry
MCP registry, active

More from miller-joe

Related Finance & Commerce MCP servers

View all
1nicofains1 avatarAgentic Adsnicofains1/agentic-adsAd network for AI agents — monetize MCP servers with contextual ads. 70% revenue share.0stars
2plagtech avatarSpraay Solana Gatewayplagtech/spraay-solana-gatewayBatch send SOL or any SPL token to 1000+ wallets via x402. AI agent payments on Solana.0stars
3pipeboard-co avatarMeta Adspipeboard-co/meta-ads-mcpProvides an MCP server to analyze, manage, and optimize Meta Ads campaigns via AI across Facebook, Instagram, and Meta platforms.908stars
4jackson-cmd avatarRisk-Aware Trading Agentsjackson-cmd/risk-aware-trading-agentsAI trading agents for US stocks: point-in-time news backtests, a frozen 2026 market, paper trading112stars
5amekala avatarAdsamekala/ads-mcpManage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.106stars
6kuudoai avatarAmazon Ads Mcpkuudoai/amazon_ads_mcpAmazon Ads API MCP server for Amazon Advertising API73stars