shopify-multi-store
Shopify Multi Store
이 Codex 플러그인은 하나의 태스크에서 여러 Shopify Admin 스토어를 유지합니다. 각 스토어는 별도의 별칭과 액세스 토큰을 가지므로, 스토어를 전환해도 다른 스토어의 연결이 끊기지 않습니다.
요구 사항
Keychain 액세스가 가능한 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 Keychain에 서비스 이름 codex-shopify-multi-store로 저장합니다. 구성 파일에는 액세스 토큰이 포함되지 않습니다.
기존 툴킷 가져오기
호환되는 멀티스토어 stores.json 파일을 가져옵니다:
npm run import-legacy -- /absolute/path/to/stores.json가져오기는 각 토큰을 macOS Keychain에 저장합니다. 두 구성 파일을 소유자 전용 액세스로 변경합니다. 레거시 자격 증명 파일이 더 이상 필요하지 않으면 삭제합니다.
각 태스크에 필요한 Admin API 범위만 사용하세요. Shopify는 이러한 범위를 통해 사용 가능한 데이터를 제어합니다.
스토어 관리
구성된 스토어를 나열합니다:
npm run configure -- list하나의 스토어와 해당 Keychain 토큰을 제거합니다:
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