Summary
Wraps the Shopify Admin REST API (2024-01 version) to give Claude access to your store's products, orders, and customers. You get five straightforward tools: list and fetch products by ID, list and fetch orders with optional status filtering, and list customers. It's part of the Pipeworx gateway system, which means you can either use it standalone or access it through their unified gateway alongside 673+ other data sources. The ask_pipeworx interface lets you query in plain English instead of calling tools directly. Runs over streamable HTTP, so no local installation needed. Reach for this when you want Claude to answer questions about inventory, check order details, or pull customer data without building your own Shopify integration.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
36 tools
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
positionintegerOptional 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_idintegerIdentifier of the product to add.
collection_idintegerIdentifier of the *custom collection*.
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_idstringThe 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
titlestringUnique 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
notestringAn optional note about the customer.
tagsstringA comma-separated string of tags to associate with the customer.
emailstringThe customer's unique email address.
phonestringThe customer's phone number (E.164 format recommended).
passwordstringThe customer's password. If provided, password_confirmation is also required.
addressesarrayA list of addresses for the customer.
last_namestringThe customer's last name.
first_namestringThe customer's first name.
verified_emailbooleanWhether the customer has verified their email address.
send_email_invitebooleanIf true, sends the customer an email invite to create an account.
send_email_welcomebooleanWhether to send the customer a welcome email. Defaults to true. If send_email_invite is true, this can be set to false.default: true
password_confirmationstringConfirmation of the customer's password. Required if password is provided.
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
currencystringThe three-letter ISO 4217 currency code for the amounts in the order (e.g., USD, CAD, EUR).
total_taxnumberThe total amount of tax for the order. This should be a numeric value representing the sum of all taxes.
line_itemsarrayA 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 `title`. At least one line item is required.
customer_idstringThe unique identifier of the customer associated with this order. If provided, the order will be linked to this customer. This field is optional.
transactionsarrayA list of transaction objects associated with the order, typically representing payment information. Each object usually includes `kind` (e.g., 'sale', 'authorization'), `amount`, `status`, and `gateway`.
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
titlestringThe title of the product, typically required by Shopify.
vendorstringThe name of the product's vendor or manufacturer.
variantsarrayProduct 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.
body_htmlstringA detailed description of the product, which can include HTML formatting for rich text.
product_typestringA category for the product, used for filtering and organizing products in Shopify.
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
imageobjectAn object containing the image details.
product_idstringThe 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
keystringThe key for the metafield. Must be at least 3 characters long.
typestringThe value type of the metafield. Defaults to single_line_text_field.default: single_line_text_field
valuestringThe value for the metafield.
namespacestringThe namespace for the metafield. Must be at least 3 characters long.
product_idstringThe unique identifier of the Shopify product to add a metafield to.
descriptionstringA description of the information that the metafield contains.
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_idstringThe 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
idstringThe 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_idstringThe unique identifier of the specific product image to be deleted.
product_idstringThe 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
product_idstringThe unique identifier of the Shopify product.
metafield_idstringThe unique identifier of the metafield to delete.
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
idsarrayA list of specific customer IDs to retrieve. If empty, all customers (matching other filters) will be retrieved.
limitintegerThe maximum number of customers to retrieve. Defaults to 50, with a maximum value of 250.default: 50
fieldsstringA comma-separated list of customer fields to include in the response (e.g., 'id,email,first_name'). By default, all fields are returned.default:
since_idstringRetrieve only customers with an ID greater than this specified ID. This is used for paginating through results.default:
created_at_maxstringFilter 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_minstringFilter 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:
updated_at_maxstringFilter customers last updated before or on this date. Format: YYYY-MM-DD or ISO 8601 datetime string.default:
updated_at_minstringFilter 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
fieldsstringComma-separated list of fields to retrieve; if omitted, all fields are returned. E.g., 'id,title,handle'.
collection_idstringThe unique identifier of the Shopify collection to retrieve.
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
limitintegerMaximum number of collects to retrieve (1-250).default: 50
fieldsstringComma-separated list of fields to retrieve (e.g., `id,collection_id,product_id`); if unspecified, all fields are returned.
since_idintegerRetrieve 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
idsstringA comma-separated string of custom collection IDs to retrieve.
limitintegerThe maximum number of custom collections to return (between 1 and 250).default: 50
handlestringFilter results by the custom collection's unique, human-readable string identifier (e.g., 'summer-specials').
product_idintegerFilter 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_idstringThe 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_idstringUnique 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
idsstringComma-separated list of order IDs to return. You may provide a list of integers; it will be converted to a comma-separated string.
namestringFilter orders by name (for example, #1001).
limitintegerMaximum number of results per page (default 50, maximum 250).
fieldsstringComma-separated list of fields to include in the response. You may provide a list; it will be converted to a comma-separated string.
statusstringFilter by order status. Valid values: open, closed, cancelled, any.
since_idintegerReturn orders with IDs greater than this ID.
page_infostringCursor for pagination. When using page_info for cursor pagination, only limit may accompany it.
created_at_maxstringShow orders created at or before this ISO 8601 timestamp (for example, 2024-12-31T23:59:59Z).
created_at_minstringShow orders created at or after this ISO 8601 timestamp (for example, 2024-01-01T00:00:00Z).
updated_at_maxstringShow orders last updated at or before this ISO 8601 timestamp.
updated_at_minstringShow orders last updated at or after this ISO 8601 timestamp.
financial_statusstringFilter by financial status. Valid values: authorized, pending, paid, partially_paid, refunded, voided, partially_refunded, any, unpaid.
processed_at_maxstringShow orders imported at or before this ISO 8601 timestamp.
processed_at_minstringShow orders imported at or after this ISO 8601 timestamp.
attribution_app_idstringShow orders attributed to a specific app ID. Use 'current' to show orders for the calling app.
fulfillment_statusstringFilter by fulfillment status. Valid values: shipped, partial, unshipped, any, unfulfilled.
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
fieldsstringComma-separated list of fields to include in the response (e.g., 'id,line_items').
order_idstringThe 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
idsstringComma-separated list of numeric order IDs to retrieve.
namestringFilter by order name (e.g., #1001).
limitintegerMaximum number of orders to return per page (1-250).
fieldsstringComma-separated list of order fields to include in the response.
statusstringFilter by order status (open,closed,cancelled,any).
since_idintegerRestrict results to after the specified ID.
page_infostringA cursor for use in pagination. When present, only limit (and fields where supported) should accompany this parameter.
created_at_maxstringShow orders created at or before this ISO 8601 timestamp.
created_at_minstringShow orders created at or after this ISO 8601 timestamp.
updated_at_maxstringShow orders last updated at or before this ISO 8601 timestamp.
updated_at_minstringShow orders last updated at or after this ISO 8601 timestamp.
financial_statusstringFilter by financial status (authorized,pending,paid,partially_paid,refunded,voided,partially_refunded,any,unpaid).
processed_at_maxstringShow orders imported/processed at or before this ISO 8601 timestamp.
processed_at_minstringShow orders imported/processed at or after this ISO 8601 timestamp.
attribution_app_idstringFilter to orders attributed to a given app ID; use 'current' to show orders for the calling app.
fulfillment_statusstringFilter by fulfillment status (shipped/fulfilled,partial,unshipped/null,any,unfulfilled).
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_idstringThe 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_idstringThe unique numerical identifier of the image associated with the product.
product_idstringThe 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
fieldsstringA 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.
since_idstringRestricts the results to product images created after the specified image ID. Useful for pagination.
product_idstringThe unique identifier of the Shopify product for which to retrieve images.
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
product_idstringThe unique identifier of the Shopify product.
metafield_idstringThe unique identifier of the metafield to retrieve.
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
keystringFilter metafields by key. If omitted, returns all metafields (or all within namespace if specified).
namespacestringFilter metafields by namespace. If omitted, returns all metafields.
product_idstringThe 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
idsstringA 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
limitintegerMaximum number of products to retrieve.default: 50
collection_idstringIdentifier for the Shopify collection. Often found in the collection's Shopify admin URL.
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
limitintegerNumber of products per page. Defaults to 50; maximum 250.default: 50
fieldsstringComma-separated list of product fields to include in the response.
page_infostringCursor 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
querystringThe GraphQL query string to execute against the Shopify Admin API.
variablesobjectVariables 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
idintegerThe unique identifier of the Shopify order whose phone number is to be updated.
phonestringThe 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
typestringThe new value type of the metafield. If not provided, the existing type will be kept.
valuestringThe new value for the metafield. If not provided, the existing value will be kept.
product_idstringThe unique identifier of the Shopify product.
descriptionstringA new description of the information that the metafield contains. If not provided, the existing description will be kept.
metafield_idstringThe unique identifier of the metafield to update.
mcp-shopify
Shopify MCP Pack — wraps the Shopify Admin REST API (2024-01)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
shopify_list_products | List products from a Shopify store. Returns up to 50 products by default. |
shopify_get_product | Get a single product by ID from a Shopify store. |
shopify_list_orders | List orders from a Shopify store, optionally filtered by status. |
shopify_get_order | Get a single order by ID from a Shopify store. |
shopify_list_customers | List customers from a Shopify store. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"shopify": {
"url": "https://gateway.pipeworx.io/shopify/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Shopify data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
