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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
collection_idintegerIdentifier of the *custom collection*.
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.
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
addressesarrayA list of addresses for the customer.
emailstringThe customer's unique email address.
first_namestringThe customer's first name.
last_namestringThe customer's last name.
notestringAn optional note about the customer.
passwordstringThe customer's password. If provided, password_confirmation is also required.
password_confirmationstringConfirmation of the customer's password. Required if password is provided.
phonestringThe customer's phone number (E.164 format recommended).
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
tagsstringA comma-separated string of tags to associate with the customer.
verified_emailbooleanWhether 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
currencystringThe three-letter ISO 4217 currency code for the amounts in the order (e.g., USD, CAD, EUR).
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.
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 `ti...
total_taxnumberThe total amount of tax for the order. This should be a numeric value representing the sum of all taxes.
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 `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_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.
titlestringThe title of the product, typically required by Shopify.
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.
vendorstringThe 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
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
descriptionstringA description of the information that the metafield contains.
keystringThe key for the metafield. Must be at least 3 characters long.
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.
typestringThe value type of the metafield. Defaults to single_line_text_field.default: single_line_text_field
valuestringThe 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_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
metafield_idstringThe unique identifier of the metafield to delete.
product_idstringThe 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_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:
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:
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
since_idstringRetrieve only customers with an ID greater than this specified ID. This is used for paginating through results.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
collection_idstringThe unique identifier of the Shopify collection to retrieve.
fieldsstringComma-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
fieldsstringComma-separated list of fields to retrieve (e.g., `id,collection_id,product_id`); if unspecified, all fields are returned.
limitintegerMaximum number of collects to retrieve (1-250).default: 50
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
handlestringFilter results by the custom collection's unique, human-readable string identifier (e.g., 'summer-specials').
idsstringA comma-separated string of custom collection IDs to retrieve.
limitintegerThe maximum number of custom collections to return (between 1 and 250).default: 50
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
attribution_app_idstringShow orders attributed to a specific app ID. Use 'current' to show orders for the calling app.
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).
fieldsstringComma-separated list of fields to include in the response. You may provide a list; it will be converted to a comma-separated string.
financial_statusstringFilter by financial status. Valid values: authorized, pending, paid, partially_paid, refunded, voided, partially_refunded, any, unpaid.
fulfillment_statusstringFilter by fulfillment status. Valid values: shipped, partial, unshipped, any, unfulfilled.
idsstringComma-separated list of order IDs to return. You may provide a list of integers; it will be converted to a comma-separated string.
limitintegerMaximum number of results per page (default 50, maximum 250).
namestringFilter orders by name (for example, #1001).
page_infostringCursor for pagination. When using page_info for cursor pagination, only limit may accompany it.
processed_at_maxstringShow orders imported at or before this ISO 8601 timestamp.
processed_at_minstringShow orders imported at or after this ISO 8601 timestamp.
since_idintegerReturn orders with IDs greater than this ID.
statusstringFilter by order status. Valid values: open, closed, cancelled, any.
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.
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
attribution_app_idstringFilter to orders attributed to a given app ID; use 'current' to show orders for the calling app.
created_at_maxstringShow orders created at or before this ISO 8601 timestamp.
created_at_minstringShow orders created at or after this ISO 8601 timestamp.
fieldsstringComma-separated list of order fields to include in the response.
financial_statusstringFilter by financial status (authorized,pending,paid,partially_paid,refunded,voided,partially_refunded,any,unpaid).
fulfillment_statusstringFilter by fulfillment status (shipped/fulfilled,partial,unshipped/null,any,unfulfilled).
idsstringComma-separated list of numeric order IDs to retrieve.
limitintegerMaximum number of orders to return per page (1-250).
namestringFilter by order name (e.g., #1001).
page_infostringA cursor for use in pagination. When present, only limit (and fields where supported) should accompany this parameter.
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.
since_idintegerRestrict results to after the specified ID.
statusstringFilter by order status (open,closed,cancelled,any).
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.
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.
product_idstringThe unique identifier of the Shopify product for which to retrieve images.
since_idstringRestricts 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_idstringThe unique identifier of the metafield to retrieve.
product_idstringThe 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
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
collection_idstringIdentifier for the Shopify collection. Often found in the collection's Shopify admin URL.
limitintegerMaximum 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
fieldsstringComma-separated list of product fields to include in the response.
limitintegerNumber of products per page. Defaults to 50; maximum 250.default: 50
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
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.
product_idstringThe unique identifier of the Shopify product.
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.
mcp-shopify
Shopify MCP Pack — wraps the Shopify Admin REST API (2024-01)
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ 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 | Fetch a single Shopify product by numeric ID, returning its title, description, variants, pricing, inventory, and images via the Admin API. |
shopify_list_orders | List orders from a Shopify store, optionally filtered by status. |
shopify_get_order | Fetch a single Shopify order by numeric ID, returning line items, customer info, fulfillment status, totals, and shipping address via the Admin API. |
shopify_list_customers | List customers in a Shopify store (up to 250 per call). Returns customer IDs, names, emails, order counts, and total spend. Requires Admin API access token and shop domain. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"shopify": {
"url": "https://gateway.pipeworx.io/shopify/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/shopify/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Shopify data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
