Skip to main content
Glama

Shopify Multi Store

Dieses Codex-Plugin hält mehrere Shopify-Admin-Stores in einer Aufgabe verfügbar. Jeder Store hat einen eigenen Alias und ein eigenes Zugriffstoken, sodass das Wechseln von Stores einen anderen Store nicht trennt.

Voraussetzungen

  • macOS mit Keychain-Zugriff

  • Node.js 20 oder neuer

  • Ein Shopify-Admin-API-Zugriffstoken für jeden Store

Related MCP server: Shopify MCP Server

Installation

Klonen Sie das Repository und installieren Sie seine Abhängigkeiten:

git clone https://github.com/alex-brecher/shopify-multi-store.git
cd shopify-multi-store
npm ci
npm run build

Installieren Sie das lokale Plugin in Codex mithilfe des geklonten Verzeichnisses. Das Repository enthält das Codex-Plugin-Manifest und die MCP-Server-Konfiguration.

Store hinzufügen

  1. Öffnen Sie ein Terminal in diesem Plugin-Verzeichnis.

  2. Führen Sie diesen Befehl aus:

npm run configure -- add
  1. Geben Sie einen kurzen Store-Alias ein.

  2. Geben Sie die permanente *.myshopify.com-Domain ein.

  3. Geben Sie das Admin-API-Zugriffstoken ein.

  4. Wiederholen Sie den Befehl für jeden Store.

Das Skript speichert jedes Token in der macOS-Keychain unter dem Dienstnamen codex-shopify-multi-store. Die Konfigurationsdatei enthält keine Zugriffstokens.

Vorhandenes Toolkit importieren

Importieren Sie eine kompatible Multi-Store-stores.json-Datei:

npm run import-legacy -- /absolute/path/to/stores.json

Der Import speichert jedes Token in der macOS-Keychain. Er ändert beide Konfigurationsdateien auf Zugriff nur für den Eigentümer. Löschen Sie die alte Anmeldedatendatei, wenn Sie sie nicht mehr benötigen.

Verwenden Sie nur die Admin-API-Bereiche, die jede Aufgabe benötigt. Shopify steuert die verfügbaren Daten über diese Bereiche.

Stores verwalten

Listen Sie die konfigurierten Stores auf:

npm run configure -- list

Entfernen Sie einen Store und sein Keychain-Token:

npm run configure -- remove store-alias

Verfügbare Tools

  • shopify_list_stores listet die verbundenen Store-Aliasse auf.

  • shopify_get_shop_info ruft die Identität eines Stores ab.

  • shopify_graphql_query führt eine schreibgeschützte Admin-GraphQL-Abfrage aus.

  • shopify_graphql_mutation ändert einen Store nach genauer Autorisierung.

Jede Store-Aktion benötigt einen Store-Alias. Diese Anforderung verringert das Risiko einer Änderung am falschen Store.

Sicherheit

  • Committen Sie niemals Zugriffstokens, OAuth-Client-Geheimnisse, .env-Dateien oder stores.json-Dateien mit Anmeldedaten.

  • Gewähren Sie nur die Shopify-Admin-API-Bereiche, die für die vorgesehenen Aufgaben erforderlich sind.

  • Bestätigen Sie den Ziel-Store, bevor Sie eine Mutation ausführen.

  • Siehe SECURITY.md für Anweisungen zur Meldung.

Entwicklung

npm ci
npm test

Lizenz

MIT

Available Tools

31 tools
shopify_bulk_exportBulk ExportA
Read-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_accessA
Read-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_collectionA
Destructive

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_discountB
Destructive

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_fulfillmentA
Destructive

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_productA
Destructive

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 ActionA
Read-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 ActionsA
Read-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 RecordA
Read-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 InformationA
Read-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 StoreA
Destructive

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 StoreA
Read-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 StoresA
Read-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_schemaC
Read-onlyIdempotent

Explore the Admin GraphQL schema for this store's API version.

Inputs: store (required), type_name (required).

shopify_list_storesList Shopify StoresA
Read-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_manageA
Destructive

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_metafieldsA
Destructive

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_redirectsA
Destructive

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 ReportA
Read-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 ActionA
Destructive

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_search_docs_chunksA
Read-onlyIdempotent

Search Shopify documentation and return source links. No store credentials are sent.

Inputs: prompt (required), api_name, max_num_results.

shopify_set_inventoryA
Destructive

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_tagsA
Destructive

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_collectionA
Destructive

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_customerA
Destructive

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_orderA
Destructive

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_pricesA
Destructive

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_productB
Destructive

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_imageA
Destructive

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_codeblocksB
Read-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

    B3.1/5.0

    Scored across 31 tools

    Disambiguation2/5

    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 Consistency2/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 npm
      1
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables management of Shopify store via GraphQL, including products, orders, inventory, and discounts with security features like preview mode and write protection.
      -