shopify-multi-store
Shopify Multi Store
该 Codex 插件可在单个任务中维护多个 Shopify Admin 商店。每个商店有独立的别名和访问令牌,因此切换商店不会断开其他商店的连接。
要求
带有钥匙串访问权限的 macOS
Node.js 20 或更高版本
每个商店的 Shopify Admin API 访问令牌
Related MCP server: Shopify MCP Server
安装
克隆仓库并安装其依赖项:
git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm run build使用克隆的目录在 Codex 中安装本地插件。仓库包含 Codex 插件清单和 MCP 服务器配置。
添加商店
在此插件目录中打开终端。
运行此命令:
npm run configure -- add输入简短的商店别名。
输入永久的
*.myshopify.com域名。输入 Admin API 访问令牌。
对每个商店重复该命令。
脚本会将每个令牌保存在 macOS 钥匙串中,服务名为 codex-shopify-multi-store。配置文件不包含任何访问令牌。
导入现有工具包
导入兼容的多商店 stores.json 文件:
npm run import-legacy -- /absolute/path/to/stores.json导入会将每个令牌保存在 macOS 钥匙串中。它会把两个配置文件改为仅所有者可访问。当不再需要旧凭据文件时,请将其删除。
仅使用每个任务所需的 Admin API 作用域。Shopify 通过这些作用域控制可用数据。
管理商店
列出已配置的商店:
npm run configure -- list移除一个商店及其钥匙串令牌:
npm run configure -- remove store-alias可用工具
shopify_list_stores列出已连接的商店别名。shopify_get_shop_info获取一个商店的身份信息。shopify_graphql_query运行只读的 Admin GraphQL 查询。shopify_graphql_mutation在获得明确授权后更改一个商店。
每次商店操作都需要商店别名。此要求降低了错误更改商店的风险。
安全
切勿提交访问令牌、OAuth 客户端密钥、
.env文件或包含凭据的stores.json文件。仅授予预期任务所需的 Shopify Admin API 作用域。
在执行变更操作前确认目标商店。
有关报告说明,请参阅 SECURITY.md。
开发
npm ci
npm test许可证
MIT
Available Tools
31 toolsshopify_bulk_exportBulk ExportARead-only
Export a whole resource from one store in one step, with no pagination or size limit: orders, products, variants, customers, inventory (levels per location), collections or draft orders, with an optional Shopify search filter such as "created_at:>=2026-10-01". Starts a Shopify bulk operation, waits up to waitSeconds, and returns the JSONL download URL (valid 7 days) and row counts; sampleRows also returns the first rows. Large stores can take minutes: call again with action:"status" and the id. resource custom runs your own bulk query. Changes nothing in the store.
Inputs: store (required), id, query, action, +5 more.
shopify_check_accessARead-onlyIdempotent
For one or many stores, report the shop identity and granted Admin API access scopes, compare them against every tool's requirement (see src/scope-requirements.ts; tools with several resources or reports are listed as tool:resource), and report missing scopes and which tools would fail. Omit stores to check every configured store.
Inputs: stores.
shopify_create_collectionADestructive
Create a manual collection (optional productIds) or a smart collection (ruleSet). Pass publicationIds to publish to explicitly selected channels. Defaults to dryRun:true, which previews the input without creating anything.
Inputs: store (required), title (required), image, dryRun, +5 more.
shopify_create_discountBDestructive
Create a percentage discount code with an explicit start date and customer audience. Defaults to dryRun:true, which resolves segments and previews the discount without creating it.
Inputs: code (required), store (required), title (required), startsAt (required), +11 more.
shopify_create_fulfillmentADestructive
Fulfill the remaining quantities of an order's OPEN and IN_PROGRESS fulfillment orders with optional tracking. notifyCustomer defaults to false. Requires read_merchant_managed_fulfillment_orders and write_merchant_managed_fulfillment_orders (Shopify reports any other missing scope, such as for fulfillment orders assigned to a fulfillment service). Defaults to dryRun:true.
Inputs: store (required), orderId (required), dryRun, trackingUrl, +3 more.
shopify_create_productADestructive
Create a product with options, variants and images, and optionally add it to a manual collection. Defaults to status DRAFT and to dryRun:true, which previews the input without creating anything.
Inputs: store (required), title (required), tags, price, +9 more.
shopify_describe_actionDescribe a Shopify Admin ActionARead-onlyIdempotent
Full signature of one Admin API mutation: arguments with types, the expanded input object fields (required markers, enum values, descriptions), the payload fields, a ready-to-edit GraphQL document with a default selection, a variables template with the required fields, a scope hint, and whether it is destructive (then shopify_run_action needs confirm set to the mutation name).
Inputs: mutation (required), depth, store, apiVersion.
shopify_find_actionsFind Shopify Admin ActionsARead-onlyIdempotent
Search every Shopify Admin API mutation (hundreds of write actions, most without a dedicated tool) by keyword and optional category. Returns each action's name, one-line description, category, whether it is destructive, which dedicated tools already cover it, and a scope hint. Next: shopify_describe_action for the full signature, then shopify_run_action.
Inputs: limit, query, store, offset, +3 more.
shopify_getGet a Shopify RecordARead-onlyIdempotent
Read one record by GID from one store. Follow each returned cursor independently. Resources:
product: Product details, variants (first/after) and media (mediaAfter). id: Product GID.
collection: Collection details, rules and a page of products. id: Collection GID.
order: Order, shipping, fulfillment, tracking and a page of line items. id: Order GID.
inventory: Inventory by product (id: Product GID) or inventory item (id: InventoryItem GID, pages through locations).
metafields: Metafields of any owner (id: owner GID); optional namespace and key.
theme_files: Theme file contents. id: OnlineStoreTheme GID; optional filenames, else pages through every file.
blog_articles: A blog's articles. id: Blog GID.
uploaded_image: Image processing status and CDN URL. id: MediaImage GID.
bulk_operation: A bulk operation's status and result URLs. id: BulkOperation GID. Partial exports stay marked incomplete.
customer: Customer details, addresses, marketing consent state and a page of orders, newest first. id: Customer GID.
draft_order: Draft order with status, totals, addresses and line items. id: DraftOrder GID.
variants: Every variant field of a product (price, barcode, tax, inventory policy, weight, cost, origin, HS code, options) with first/after. id: Product GID.
order_transactions: An order's payment transactions (authorizations, captures, refunds, voids). id: Order GID.
order_refunds: An order's refunds with refunded items, restock status and transactions. id: Order GID.
fulfillment_orders: An order's fulfillment orders with status, location, delivery method, holds and line items. id: Order GID.
webhook: One webhook subscription of this app. id: WebhookSubscription GID.
page: One Online Store page with its HTML body, handle, isPublished, publishedAt and templateSuffix. id: Page GID.
article: One blog article with body, summary, author, tags, image, isPublished, publishedAt and its blog. id: Article GID.
metaobject: One metaobject: handle, type, displayName, fields (key, type, value, jsonValue), updatedAt, capabilities. id: Metaobject GID.
metaobject_definition: One metaobject definition with full field definitions and validations. id: MetaobjectDefinition GID.
fulfillment: One fulfillment: status, tracking info (company, number, url), line items, location and createdAt. id: Fulfillment GID (from the order's fulfillments).
discount: One discount in full: status, summary, dates, value, minimum requirement, who is eligible, items it covers, combinesWith, usage limits and usage, and the first 20 codes with a code count. id: DiscountNode, DiscountCodeNode or DiscountAutomaticNode GID.
Inputs: id (required), store (required), resource (required), key, +5 more.
shopify_get_shop_infoGet Shopify Store InformationARead-onlyIdempotent
Get identity and account information from one named Shopify Admin store. Use this tool before a sensitive change to make sure that the selected store is correct.
Inputs: store (required).
shopify_graphql_mutationChange a Shopify StoreADestructive
Run one GraphQL Admin API mutation against one named store. Set confirm to true only after the user authorizes the exact store and change. Destructive mutations (see shopify_describe_action; some are destructive only with certain arguments, such as a product status of ARCHIVED or notifyCustomer true) need confirm set to the mutation name instead, and denylisted mutations are refused, exactly as in shopify_run_action. The result reports each top-level mutation field as applied, rejected, or unknown, and the store as applied, rejected, partial, or unknown; after partial or unknown, retry only the rejected fields in a new document.
Inputs: store (required), confirm (required), mutation (required), variables.
shopify_graphql_queryQuery a Shopify StoreARead-onlyIdempotent
Run one read-only GraphQL Admin API query against one named store. Use cursor pagination and request only necessary fields.
Inputs: query (required), store (required), variables.
shopify_graphql_query_manyQuery Multiple Shopify StoresARead-onlyIdempotent
Run the same read-only GraphQL Admin API query across multiple named stores in parallel. Each store returns its own success or error result.
Inputs: query (required), stores (required), variables.
shopify_graphql_schemaCRead-onlyIdempotent
Explore the Admin GraphQL schema for this store's API version.
Inputs: store (required), type_name (required).
shopify_list_storesList Shopify StoresARead-onlyIdempotent
List every Shopify Admin store that remains connected to this plugin. On a hosted server in per-user mode, lists only the stores you have connected with your own Shopify account and names the others with a link to connect them. This tool does not expose access tokens.
Inputs: no named parameters.
shopify_manageADestructive
Guided writes for one store, chosen by operation. Every operation reads the current state first, defaults to dryRun:true (a preview that changes nothing), never notifies customers unless asked, and reads the result back after a write. Put the operation's fields in input. Operations:
webhook: Create, update or delete one of this app's webhook subscriptions (webhookSubscriptionCreate / Update / Delete). Deliver to an HTTPS URL, Google Pub/Sub (pubsub://project:topic) or Amazon EventBridge. A subscription keeps sending store data to its uri until it is deleted, whoever made it, so create, and an update that changes uri, need confirm:"webhook"; delete needs confirm:"delete". create refuses a duplicate topic and uri. The name records who made the change. Shopify shows an app only the webhook subscriptions it created; other apps' subscriptions are not listed. input: {action: create|update|delete, id?, topic?, uri?, format?: JSON|XML, filter?, includeFields?: [...], metafieldNamespaces?: [...], name?}
page: Create, update or delete an Online Store page (pageCreate / pageUpdate / pageDelete). body is HTML. update and delete read the page first; update previews current and changes. A handle change on update can leave the old URL redirecting (redirectNewHandle). delete cannot be undone and needs confirm:"delete". seo is not available: Shopify's page input has no SEO fields. input: {action: create|update|delete, id?, title?, body?, handle?, isPublished?, publishDate?, templateSuffix?, redirectNewHandle?}
article: Create, update or delete a blog article (articleCreate / articleUpdate / articleDelete). create needs blogId, title and author (a name). body and summary are HTML; imageUrl is a public https URL with imageAlt. update and delete read the article first; blogId on update moves it to another blog. delete cannot be undone and needs confirm:"delete". input: {action: create|update|delete, id?, blogId?, title?, body?, summary?, author?, tags?: [...], imageUrl?, imageAlt?, isPublished?, publishDate?, handle?, templateSuffix?, redirectNewHandle?}
blog: Update a blog's title, handle, commentPolicy (AUTO_PUBLISHED, MODERATED or CLOSED) or templateSuffix (blogUpdate). Update only: blogs are not created or deleted here. Reads the blog first; dryRun:true (the default) previews. redirectNewHandle and redirectArticles keep old URLs working after a handle change. input: {id, title?, handle?, commentPolicy?: AUTO_PUBLISHED|MODERATED|CLOSED, templateSuffix?, redirectNewHandle?, redirectArticles?}
metaobject: Create, update, upsert or delete one metaobject entry (metaobjectCreate / Update / Upsert / Delete). Reads the definition first and rejects unknown field keys before any write. create: type, optional handle, fields [{key, value}], optional status DRAFT or ACTIVE (publishable types). update: id plus fields and/or status. upsert: type plus handle plus fields. delete: id, needs confirm "delete". input: {action: create|update|upsert|delete, id?, type?, handle?, fields?: [{key, value}], status?: DRAFT|ACTIVE}
metafield_definition: Create one metafield definition (metafieldDefinitionCreate); create only. Refuses when ownerType, namespace and key already have a definition. The access scope depends on the owner type (for example write_products for PRODUCT, write_customers for CUSTOMER), so none is checked up front and Shopify rejects a missing one. type is a metafield type name such as single_line_text_field or list.single_line_text_field; validations are {name, value} pairs; pin puts it at the top of the admin page. input: {action: create, ownerType, namespace, key, name, type, description?, validations?: [{name, value}], pin?}
draft_order: Edit or delete an existing draft order. update (draftOrderUpdate): any of lineItems (replaces the whole list), customerId, email, note, tags (replaces), shippingAddress, billingAddress, appliedDiscount, shippingLine and reserveInventoryUntil; the preview runs draftOrderCalculate when lineItems change. delete (draftOrderDelete) cannot be undone and needs confirm:"delete". Completed draft orders are refused. No invoice is sent. Create and complete are separate operations. input: {action: update|delete, id, lineItems?: [{variantId?, title?, price?, quantity, sku?, taxable?, requiresShipping?}], customerId?, email?, note?, tags?: [...], shippingAddress?: {firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}, billingAddress?: {firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}, appliedDiscount?: {value, valueType: FIXED_AMOUNT|PERCENTAGE, title?, description?}, shippingLine?: {title, price}, currencyCode?, reserveInventoryUntil?}
file: Create, rename or delete files in Content > Files, any content type. create (fileCreate) copies a public HTTPS originalSource URL into Shopify as FILE, IMAGE, VIDEO, EXTERNAL_VIDEO or MODEL_3D, with alt and filename. update (fileUpdate) changes alt and filename. delete (fileDelete, up to 50 ids) cannot be undone and needs confirm:"delete"; it lists the files first. Shopify processes files asynchronously: fileStatus starts as UPLOADED or PROCESSING and becomes READY. Check with shopify_search files or shopify_get uploaded_image. input: {action: create|update|delete, originalSource?, contentType?: FILE|IMAGE|VIDEO|EXTERNAL_VIDEO|MODEL_3D, alt?, filename?, id?, ids?: [...]}
fulfillment: Change tracking on a fulfillment (update_tracking, fulfillmentTrackingInfoUpdate) or cancel it (cancel, fulfillmentCancel). Cancel reverses the fulfillment and reopens its items on new fulfillment orders; it needs confirm:"cancel". notifyCustomer defaults to false. Reads the fulfillment first. Needs a fulfillment-order write scope; write_merchant_managed_fulfillment_orders covers fulfillments of merchant-managed locations. input: {action: update_tracking|cancel, id, company?, number?, url?, notifyCustomer?}
inventory: Inventory changes beyond shopify_set_inventory. adjust: up to 100 relative changes {inventoryItemId or sku, locationId, delta} (inventoryAdjustQuantities), each checked against the current quantity. move: items {inventoryItemId or sku, quantity} from fromLocationId to toLocationId, taken from available stock, done as one atomic adjust (inventoryMoveQuantities cannot cross locations). move_state: move quantity between states at one location, such as available to damaged (inventoryMoveQuantities; needs referenceDocumentUri). update_item: tracked, cost, countryCodeOfOrigin, harmonizedSystemCode, provinceCodeOfOrigin, requiresShipping (inventoryItemUpdate). activate: stock an item at a location (inventoryActivate). deactivate: remove an item from a location and its stock tracking there (inventoryDeactivate; needs confirm:"deactivate"). A SKU must match exactly one inventory item or the call is refused. Reads current quantities first; dryRun shows each row's before and after. input: {action: adjust|move|move_state|update_item|activate|deactivate, changes?: [{inventoryItemId?, sku?, locationId, delta}], items?: [{inventoryItemId?, sku?, quantity}], quantityName?: available, reason?: correction|cycle_count_available|damaged|movement_created|movement_updated|movement_received|movement_canceled|other|promotion|quality_control|received|reservation_created|reservation_deleted|reservation_updated|restock|safety_stock|shrinkage, referenceDocumentUri?, fromLocationId?, toLocationId?, locationId?, fromState?: available|damaged|quality_control|reserved|safety_stock, toState?: available|damaged|quality_control|reserved|safety_stock, inventoryItemId?, sku?, tracked?, cost?, countryCodeOfOrigin?, harmonizedSystemCode?, provinceCodeOfOrigin?, requiresShipping?, available?}
discount: Create, activate, deactivate, delete, add codes to, or lightly update a discount, code or automatic. Percentages are FRACTIONS from 0 to 1 (0.2 is 20% off). Money is a decimal string in the shop currency. create: kind amount_off, percentage, free_shipping or bxgy, method code or automatic, all customers only; refuses a code that already exists; needs an explicit startsAt; the dry run states the exact discount in words. activate and deactivate work on code and automatic discounts. delete needs confirm:"delete". add_codes adds up to 250 codes to a code discount and refuses codes that already exist. update changes only title, startsAt, endsAt and usageLimit. Use shopify_create_discount for a quick percentage code with customer segments. input: {action: create|activate|deactivate|delete|add_codes|update, id?, kind?: amount_off|percentage|free_shipping|bxgy, method?: code|automatic, title?, code?, startsAt?, endsAt?, percentage?, amount?, appliesOnEachItem?, appliesOncePerCustomer?, usageLimit?, minimumSubtotal?, minimumQuantity?, customerEligibility?, productIds?: [...], collectionIds?: [...], combinesWith?: {productDiscounts?, orderDiscounts?, shippingDiscounts?}, maximumShippingPrice?, buyQuantity?, buyProductIds?: [...], buyCollectionIds?: [...], getQuantity?, getProductIds?: [...], getCollectionIds?: [...], getPercentage?, usesPerOrderLimit?, codes?: [...]}
variants: Create, update and/or delete variants of one product (productVariantsBulkCreate / BulkUpdate / BulkDelete). Updates and deletes must name variants of this product. sku, tracked, cost, weight, requiresShipping, countryCodeOfOrigin and harmonizedSystemCode set the variant's inventory item. input: {productId, create?: [{price, compareAtPrice?, sku?, barcode?, optionValues: [{optionName, name}], inventoryPolicy?: DENY|CONTINUE, taxable?, tracked?, cost?, requiresShipping?, weight?: {value, unit: GRAMS|KILOGRAMS|OUNCES|POUNDS}, countryCodeOfOrigin?, harmonizedSystemCode?}], update?: [{id, price?, compareAtPrice?, sku?, barcode?, optionValues?: [{optionName, name}], inventoryPolicy?: DENY|CONTINUE, taxable?, tracked?, cost?, requiresShipping?, weight?: {value, unit: GRAMS|KILOGRAMS|OUNCES|POUNDS}, countryCodeOfOrigin?, harmonizedSystemCode?}], delete?: [...], strategy?: DEFAULT|REMOVE_STANDALONE_VARIANT|PRESERVE_STANDALONE_VARIANT}
options: Create, update and/or delete product options such as Size or Color (productOptionsCreate / productOptionUpdate / productOptionsDelete). createVariants:true also creates or removes the variants an option change implies; the default leaves variants as they are. input: {productId, create?: [{name, values: [...], position?}], update?: [{id, name?, position?, addValues?: [...], renameValues?: [{id, name}], deleteValueIds?: [...]}], delete?: [...], createVariants?}
delete: Permanently delete one product or customer by GID (productDelete / customerDelete). This cannot be undone: archive a product (shopify_update_product status ARCHIVED) when it may come back. Shopify refuses to delete a customer who has orders. input: {id}
create_customer: Create a customer (customerCreate) and add any addresses (customerAddressCreate; the first becomes the default). Marketing consent is out of scope: record it only from the customer's own opt-in. dryRun:true (the default) checks for an existing customer with the same email and previews the input. input: {firstName?, lastName?, email?, phone?, note?, tags?: [...], taxExempt?, locale?, addresses?: [{firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}]}
customer_address: Create, update, delete or set the default mailing address of a customer (customerAddressCreate / Update / Delete, customerUpdateDefaultAddress). addressId must belong to the customer. input: {customerId, action: create|update|delete|set_default, addressId?, address?: {firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}, setAsDefault?}
merge_customers: Merge two customer records into one (customerMerge). This cannot be undone. dryRun:true (the default) runs Shopify's customerMergePreview, which shows the resulting customer, the fields kept and anything blocking the merge. overrideFields chooses which customer's name, email, phone or default address to keep. input: {customerOneId, customerTwoId, overrideFields?: {customerIdOfFirstNameToKeep?, customerIdOfLastNameToKeep?, customerIdOfEmailToKeep?, customerIdOfPhoneNumberToKeep?, customerIdOfDefaultAddressToKeep?, note?, tags?: [...]}}
create_draft_order: Create a draft order (draftOrderCreate) from variants and/or custom line items, with an optional customer, addresses, discount and shipping line. No invoice is sent. dryRun:true (the default) runs draftOrderCalculate, which returns Shopify's real totals without creating anything. input: {lineItems: [{variantId?, title?, price?, quantity, sku?, taxable?, requiresShipping?}], customerId?, email?, phone?, note?, tags?: [...], poNumber?, taxExempt?, shippingAddress?: {firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}, billingAddress?: {firstName?, lastName?, company?, address1?, address2?, city?, provinceCode?, countryCode?, zip?, phone?}, useCustomerDefaultAddress?, appliedDiscount?: {value, valueType: FIXED_AMOUNT|PERCENTAGE, title?, description?}, discountCodes?: [...], shippingLine?: {title, price}, currencyCode?}
complete_draft_order: Complete a draft order and turn it into a real order (draftOrderComplete). Inventory is reserved and the order appears in the orders list. Without paymentGatewayId Shopify marks the order as paid. input: {id, paymentGatewayId?}
order_status: Cancel, close, reopen or mark an order as paid (orderCancel / orderClose / orderOpen / orderMarkAsPaid). cancel cannot be undone; it refunds the original payment only with refund:true and restocks only with restock:true. notifyCustomer defaults to false. The preview checks the action is allowed. input: {id, action: cancel|close|open|mark_paid, reason?: CUSTOMER|DECLINED|FRAUD|INVENTORY|STAFF|OTHER, refund?, restock?, notifyCustomer?, staffNote?}
refund: Refund line items and/or shipping on an order (refundCreate). The tool asks Shopify for the suggested refund (amounts, tax and the transactions to refund against) and refunds exactly that. dryRun:true (the default) returns the suggestion. To apply, pass dryRun:false with expectedAmount equal to the suggested total from the preview; any difference stops the write. notify defaults to false. input: {orderId, lineItems?: [{lineItemId, quantity, restockType?: NO_RESTOCK|CANCEL|RETURN, locationId?}], refundShipping?, shippingAmount?, note?, notify?, expectedAmount?}
Inputs: store (required), operation (required), input, dryRun, +1 more.
shopify_metafieldsADestructive
Set (metafieldsSet) and/or delete (metafieldsDelete) up to 25 metafields each, for any owner GID. Read them with shopify_get resource metafields. Defaults to dryRun:true.
Inputs: store (required), set, delete, dryRun.
shopify_redirectsADestructive
Create and/or delete up to 100 URL redirects each, with a per-redirect outcome (applied, rejected or unknown) and a store status. List them with shopify_search resource redirects. Requires write_online_store_navigation. Defaults to dryRun:true.
Inputs: store (required), create, delete, dryRun.
shopify_reportRun a Shopify ReportARead-onlyIdempotent
Run one read-only report across selected stores; each store returns its own result and completeness indicators. Reports:
portfolio_snapshot: Shop identity and product, order, customer and location counts. stores optional (all stores).
store_locations: Active, inactive, legacy, fulfillment, inventory and address status of locations. stores optional (all stores).
compare_inventory: Inventory, price, status and catalog details for exact SKUs. Needs skus (1-50).
compare_prices: Price and compare-at price for exact SKUs, with mismatches and missing variants. Needs skus (1-50).
get_product_everywhere: One exact SKU or handle across stores. Needs identifier and matchBy (sku or handle).
compare_catalog: Titles, status, vendor, type and inventory for exact product handles. Needs handles (1-50).
compare_collections: Titles, sort order, product counts, SEO and images for exact collection handles. Needs handles (1-50).
catalog_gap_report: Products missing or with different status across stores. first: products scanned per store (default 250).
catalog_health: Missing vendor, type, SEO, media, alt text, and active products without inventory. first (default 100).
duplicate_sku_report: SKUs repeated inside a store and shared across stores. first: variants scanned per store (default 250).
low_stock_report: Active variants at or below threshold (default 10), separating low, zero and negative.
recent_product_changes: Products updated in the last days (default 7). first (default 100).
list_unfulfilled_orders: Recent open unfulfilled orders. days (default 7), first (default 25).
fulfillment_sla_report: Open unfulfilled orders by age bucket and SLA breaches. lookbackDays (default 90), slaDays (default 2), first (default 100).
order_summary: Order values, discounts, shipping, tax, cancellations and statuses; currencies separate. days (default 30), first (default 100).
customer_growth: New customers in the current and previous period of days (default 30).
analytics: Run one ShopifyQL query on each store and return columns, rows and a chart hint. Needs query and read_reports.
Inputs: report (required), days, skus, first, +8 more.
shopify_run_actionRun a Shopify Admin ActionADestructive
Run any Shopify Admin API mutation on one to one hundred stores. Give a mutation name (a default document is built) or a full single-mutation document, plus variables shared by every store and/or variablesByStore (IDs differ per store). dryRun (the default) validates the document and variables against each store's API version and looks up every record ID in the variables and the document; nothing is changed. The preview says whether it is complete: targets chosen by a search, saved search, filter, or "all" flag, more than 250 IDs, or IDs that do not resolve make it incomplete, and then applying also needs acknowledgeIncompletePreview: true. dryRun false applies it; every ID is looked up again first, and IDs that do not resolve refuse the apply unless acknowledgeIncompletePreview is true. Destructive actions (delete, cancel, refund and similar) need confirm set to the mutation name. Mutations are never retried automatically. On a hosted server in per-user mode, Shopify limits this to what your own staff account may do.
Inputs: stores (required), dryRun, confirm, document, +4 more.
shopify_searchSearch a Shopify ResourceARead-onlyIdempotent
List or search one kind of record with cursor pagination, on one store (store) or several in parallel (stores; each store returns its own result and cursor). Resources:
products: Products (query: Shopify product search syntax).
collections: Manual and smart collections.
orders: Orders, newest first (query: Shopify order search syntax).
customers: Customers. Protected customer data permissions apply.
publications: Sales channel publication IDs (no query; 100 per page).
redirects: URL redirects.
pages: Online Store pages.
files: Files (images, videos, generic files).
metaobjects: Metaobjects of one type (type required).
markets: Markets (no query).
themes: Themes with their role; MAIN is live (no query).
delivery_profiles: Delivery profiles with zones, methods and flat rates (no query).
locations: Locations with address, active status and fulfillment capabilities (query: location search syntax).
price_lists: Price lists with currency, adjustment and catalog (no query).
metafield_definitions: Metafield definitions for one owner type (type required: PRODUCT, PRODUCTVARIANT, CUSTOMER, ORDER, COLLECTION, ...).
draft_orders: Draft orders, most recently updated first (query: draft order search syntax).
webhooks: This app's webhook subscriptions (query: such as "topic:ORDERS_CREATE"). Shopify shows an app only the webhook subscriptions it created; other apps' subscriptions are not listed.
blogs: Online Store blogs (query: such as "handle:news" or "title:Recipes"). Returns id, title, handle, commentPolicy, articlesCount, templateSuffix, updatedAt.
metaobject_definitions: Metaobject definitions: type, name, displayNameKey, field definitions (key, name, type, required), entry count, access and capabilities. No query filter; page with after.
marketing_events: Marketing events (campaigns, ads, posts) recorded by marketing apps, newest first: id, type, remoteId, startedAt, endedAt, description, marketingChannelType, utm fields and sourceAndMedium. query: Shopify search syntax such as "started_at:>=2026-10-01" or "type:AD".
abandoned_checkouts: Abandoned checkouts, newest first: id, name, createdAt, updatedAt, abandonedCheckoutUrl, totalPriceSet, customer id and email when present, and lineItemsQuantity (units, not distinct lines). Needs the protected customer data permission for customer fields; Shopify returns only checkouts from the last 90 days. query: such as "created_at:>=2026-10-01".
discounts: Code and automatic discounts, newest first, with title, status (ACTIVE, SCHEDULED, EXPIRED), type (__typename), summary, startsAt, endsAt, usage count and the first 3 codes of code discounts. query: Shopify discount search syntax, such as "status:active", "method:code", "type:percentage" (also fixed_amount, free_shipping, bxgy), "title:summer", "times_used:>0" or "starts_at:>2026-11-01".
Inputs: resource (required), type, after, first, +3 more.
shopify_search_docs_chunksARead-onlyIdempotent
Search Shopify documentation and return source links. No store credentials are sent.
Inputs: prompt (required), api_name, max_num_results.
shopify_set_inventoryADestructive
Set available inventory at one location using compare-and-set protection: compareQuantity must equal the current available quantity. Read inventory first (shopify_get resource inventory). dryRun:true (the default) checks and previews without changing anything.
Inputs: store (required), quantity (required), locationId (required), compareQuantity (required), +4 more.
shopify_tagsADestructive
Add and/or remove tags on a product, order, customer or draft order by GID (tagsAdd/tagsRemove). Defaults to dryRun:true.
Inputs: store (required), ownerId (required), add, dryRun, +1 more.
shopify_update_collectionADestructive
Update collection fields, rules or image, and add products to a manual collection (addProductIds). dryRun:true (the default) returns the current collection and the change without applying it; dryRun:false applies it and returns before and after.
Inputs: id (required), store (required), image, title, +5 more.
shopify_update_customerADestructive
Update customer name, email, phone, note, tax exemption and tags (customerUpdate). dryRun:true (the default) returns the current customer and the change without applying it; dryRun:false applies it and returns before and after. Tags: addTags and removeTags change only the named tags; replaceTags replaces all tags. Email marketing consent is out of scope. Requires write_customers.
Inputs: id (required), store (required), note, email, +8 more.
shopify_update_orderADestructive
Update order note, email, phone, PO number, additional details (customAttributes), shipping address and tags (orderUpdate). dryRun:true (the default) returns the current order and the change without applying it; dryRun:false applies it and returns before and after. Tags: addTags and removeTags change only the named tags; replaceTags replaces all tags. Requires write_orders.
Inputs: id (required), store (required), note, email, +8 more.
shopify_update_pricesADestructive
Set price, compareAtPrice and/or unit cost for up to 250 SKUs on one store (store) or the same list on several stores in parallel (stores). Resolves each SKU to the variants whose SKU matches exactly (Shopify search is a prefix match) and groups writes by product. A SKU shared by several variants is skipped unless allowDuplicates:true. Duplicate SKU rows with conflicting values are rejected before any write; identical duplicates are collapsed. After a write, verifies each variant with a separate read-back query and reports per-item outcome (applied, applied_unverified, rejected, not_found, ambiguous, unknown, skipped, mismatch) and a store status (ok, unverified, partial, failed, unknown). Large results are trimmed, never dropped: status, counts and every item that did not apply are always returned. Defaults to dryRun:true.
Inputs: skus (required), store, dryRun, stores, +1 more.
shopify_update_productBDestructive
Update product fields, variants, media and tags. dryRun:true (the default) returns the current product and the change without applying it; dryRun:false applies it and returns before and after. Tags: addTags and removeTags change only the named tags; replaceTags replaces all tags. A status of ARCHIVED or DRAFT takes the product off every sales channel.
Inputs: id (required), store (required), seo, title, +15 more.
shopify_upload_imageADestructive
Upload a local image file or an HTTPS image to Shopify Files, wait for processing, and return its CDN URL (check it later with shopify_get resource uploaded_image). Defaults to dryRun:true, which previews the upload without sending anything.
Inputs: store (required), alt, dryRun, filename, +2 more.
shopify_validate_graphql_codeblocksBRead-onlyIdempotent
Validate Admin GraphQL operations against this store's API version without executing them.
Inputs: store (required), codeblocks (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 31 tools
Several tool pairs have unclear boundaries: shopify_manage bundles guided writes for webhooks, pages, articles, blogs, metaobjects, draft orders, files, inventory and discounts that also exist as dedicated tools (discount, inventory, fulfillment, create_draft_order, shopify_create_discount). Likewise shopify_run_action, shopify_graphql_mutation, shopify_graphql_query and shopify_graphql_query_many all overlap as generic escape hatches, and shopify_update_product vs variants vs options vs shopify_tags vs shopify_metafields require careful reading to pick correctly.
Naming mixes a shopify_ prefix for many tools (shopify_create_product, shopify_get, shopify_search, shopify_report) with bare noun or verb names (delete, variants, options, refund, inventory, fulfillment, discount, customer_address, create_draft_order, order_status). The verb_noun convention is absent in the bare-named tools, so an agent cannot predict a tool's name from its function.
31 tools exceeds a well-scoped surface, and part of that count is redundancy: four separate GraphQL escape hatches (schema, query, query_many, mutation, validate_codeblocks, run_action, describe_action, find_actions) plus a mega-tool shopify_manage duplicate capabilities already exposed by dedicated tools. The Shopify admin domain is broad, but the set could be meaningfully consolidated.
Coverage is unusually broad: products, variants, options, collections, orders, refunds, customers and addresses, inventory, discounts, files, pages, articles, blogs, metaobjects, metafields, webhooks and redirects all have lifecycle operations, and shopify_run_action fills remaining gaps. Minor omissions remain (e.g. collection delete, theme file editing, gift cards), though most are reachable through the generic mutation tools.
Maintenance
Related MCP Connectors
Manage a Shopify store's Sternify bundles, gifts, upsells, banners and reviews via OAuth.
Manage a Hyprcart store: catalog, prices, stock, orders and content, with the merchant's consent.
Connect AI to store orders, products and inventory with scoped access and human approvals.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables interaction with multiple Shopify stores simultaneously through the Storefront API. Supports product search, cart management, and store operations across configured Shopify stores through natural language.2-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Shopify store data via the GraphQL Admin API to manage products, customers, orders, and collections. Supports multi-store configurations and provides comprehensive management tools for e-commerce administration in both local and remote environments.12 npm1MIT
- FlicenseNot gradedqualityBmaintenanceEnables management of Shopify store via GraphQL, including products, orders, inventory, and discounts with security features like preview mode and write protection.-
- AlicenseNot gradedqualityDmaintenanceEnables conversational Admin API read/write across multiple Shopify stores with a production write-gate for safety.2MIT