Skip to main content
Glama
Kockatoos Shopify MCP Server

Kockatoos Shopify MCP Server

Kockatoos Shopify MCP Server

CI

Website | npm | GitHub

An MCP (Model Context Protocol) server that gives AI agents full access to the Shopify Admin API. Manage products, orders, customers, collections, fulfillments, discounts, and more through 136 tools powered by the Shopify Admin GraphQL API.


Installation

npm install @kockatoos/shopify-mcp

Or run directly with npx (no install needed):

npx @kockatoos/shopify-mcp

Related MCP server: cob-shopify-mcp

Quick Start

Step 1 — Create a Shopify app

You need a Shopify app with an access token to authenticate. There are two types:

Option A: Admin-created custom app (simplest)

  1. Go to Shopify Admin → Settings → Apps and sales channels → Develop apps

  2. Create an app, configure the required Admin API scopes, and click Install app

  3. Copy the Admin API access token shown once after installation

Use it directly in your MCP config:

{
  "mcpServers": {
    "kockatoos-shopify-mcp": {
      "command": "npx",
      "args": ["-y", "@kockatoos/shopify-mcp"],
      "env": {
        "SHOPIFY_STORE_NAME": "your-store-name",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Option B: Partner Dashboard app

Partner Dashboard apps use OAuth and don't expose an access token in the UI. Run the one-time token helper to get a permanent offline access token:

# With npm install
SHOPIFY_CLIENT_ID=xxx SHOPIFY_CLIENT_SECRET=yyy SHOPIFY_STORE_NAME=zzz \
  npx shopify-mcp-get-token

# Or if you cloned the repo
SHOPIFY_CLIENT_ID=xxx SHOPIFY_CLIENT_SECRET=yyy SHOPIFY_STORE_NAME=zzz \
  npm run get-token

Before running: add http://localhost:3456/callback to your app's Allowed Redirect URLs in the Partner Dashboard (App setup → URLs).

This opens a browser, completes the OAuth flow, and prints your access token. Then use it in your MCP config the same way as Option A.


Step 2 — Configure your MCP client

Add this to your MCP client configuration (e.g. claude_desktop_config.json, .vscode/mcp.json, or equivalent):

{
  "mcpServers": {
    "kockatoos-shopify-mcp": {
      "command": "npx",
      "args": ["-y", "@kockatoos/shopify-mcp"],
      "env": {
        "SHOPIFY_STORE_NAME": "your-store-name",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Using a local clone

git clone https://github.com/untitled-developers/shopify-mcp.git
cd shopify-mcp
npm install
npm run build

Then point your MCP client to the built output:

{
  "mcpServers": {
    "kockatoos-shopify-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/shopify-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_NAME": "your-store-name",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Configuration

Variable

Required

Description

SHOPIFY_STORE_NAME

Yes

Your store subdomain (e.g. my-store, not the full .myshopify.com)

SHOPIFY_ACCESS_TOKEN

Yes*

Permanent access token (from admin-created app or Partner Dashboard OAuth flow)

SHOPIFY_API_VERSION

No

API version (defaults to 2026-01)

* SHOPIFY_CLIENT_ID + SHOPIFY_CLIENT_SECRET can be used instead of SHOPIFY_ACCESS_TOKEN only for admin-created custom apps (store-only, no Partner Dashboard support).


Available Tools (136)

Shop (1)

Tool

Description

get_shop_info

Get store name, domain, email, plan, currency, timezone

Products (11)

Tool

Description

list_products

List products with filters (status, vendor, type) and pagination

get_product

Get full product details including variants and images

create_product

Create a product with title, description, variants, images

update_product

Update product fields (title, description, status, tags, etc.)

delete_product

Permanently delete a product by ID

list_product_metafields

List all metafields for a product (GraphQL)

get_product_metafield

Get a product metafield by namespace and key (GraphQL)

set_product_metafield

Create or update a product metafield via metafieldsSet (GraphQL)

delete_product_metafield

Delete a product metafield (GraphQL)

list_metafield_definitions

List all product metafield definitions with validations (GraphQL)

create_metafield_definition

Create a new metafield definition for products (or other resource types) with validation rules (GraphQL)

Product Images (5)

Tool

Description

list_product_images

List all images for a product

get_product_image

Get a specific product image

create_product_image

Add an image to a product by URL, with optional position and variant assignment

update_product_image

Update image alt text, position, or variant assignments

delete_product_image

Remove an image from a product

Variants (5)

Tool

Description

list_variants

List all variants of a product

get_variant

Get a specific variant

create_variant

Add a new variant to a product

update_variant

Update variant price, SKU, inventory, etc.

delete_variant

Remove a variant from a product

Collections (13)

Tool

Description

list_custom_collections

List custom (manual) collections

list_smart_collections

List smart (automated) collections

get_custom_collection

Get a custom collection by ID

get_smart_collection

Get a smart collection by ID

create_custom_collection

Create a manual collection

create_smart_collection

Create an automated collection with rules

update_custom_collection

Update a custom collection

delete_custom_collection

Delete a custom collection

update_smart_collection

Update a smart collection

reorder_collection_products

Reorder products in a manual collection

add_product_to_collection

Add a product to a custom collection

remove_product_from_collection

Remove a product from a custom collection

list_collection_products

List all products in a collection

Orders (9)

Tool

Description

list_orders

List orders with filters (status, financial status, date range)

get_order

Get full order details (line items, shipping, transactions)

update_order

Update order notes, tags, or email

close_order

Mark an order as closed/completed

cancel_order

Cancel an order with optional reason, email notification, restock

list_order_metafields

List all metafields for an order (GraphQL)

get_order_metafield

Get an order metafield by namespace and key (GraphQL)

set_order_metafield

Create or update an order metafield via metafieldsSet (GraphQL)

delete_order_metafield

Delete an order metafield (GraphQL)

Customers (9)

Tool

Description

list_customers

List customers with pagination

search_customers

Search by email, name, country, etc.

get_customer

Get full customer details and addresses

create_customer

Create a customer with email, name, phone, addresses

update_customer

Update customer fields

list_customer_metafields

List all metafields for a customer (GraphQL)

get_customer_metafield

Get a customer metafield by namespace and key (GraphQL)

set_customer_metafield

Create or update a customer metafield via metafieldsSet (GraphQL)

delete_customer_metafield

Delete a customer metafield (GraphQL)

Inventory (5)

Tool

Description

list_locations

List all warehouse/store locations

get_location

Get details of a specific location

list_inventory_levels

Get stock quantities at a location

adjust_inventory

Adjust stock by a relative amount (+/-)

set_inventory

Set stock to an absolute quantity

Draft Orders (7)

Tool

Description

list_draft_orders

List draft orders with pagination

get_draft_order

Get a draft order by ID

create_draft_order

Create a new draft order with line items

update_draft_order

Update a draft order

complete_draft_order

Convert a draft order into a real order

send_draft_order_invoice

Email the draft order invoice to the customer

delete_draft_order

Delete a draft order

Discounts — Compatibility Wrappers / GraphQL (8)

These tools keep the older Price Rules-style MCP names for backward compatibility, but they now call modern Admin GraphQL code-discount operations. Returned IDs and payloads are GraphQL discount node/redeem-code shapes.

Tool

Description

list_price_rules

List code discounts through the compatibility wrapper

get_price_rule

Get a code discount by DiscountCodeNode ID

create_price_rule

Create a basic code discount

update_price_rule

Update a basic code discount

delete_price_rule

Delete a code discount

list_discount_codes

List redeem codes for a code discount

create_discount_code

Set the code on a basic code discount

delete_discount_code

Delete a redeem code from a code discount

Discounts — Code Discounts / GraphQL (11)

Modern Shopify GraphQL discount API for code-based discounts (amount off, BXGY, free shipping).

Tool

Description

list_code_discounts

List code discounts (paginated, optional search query)

get_code_discount

Get a code discount by GID or by code string

create_code_discount_basic

Create an amount-off code discount

update_code_discount_basic

Update an amount-off code discount

create_code_discount_bxgy

Create a Buy X Get Y code discount

update_code_discount_bxgy

Update a Buy X Get Y code discount

create_code_discount_free_shipping

Create a free-shipping code discount

update_code_discount_free_shipping

Update a free-shipping code discount

activate_code_discount

Activate a code discount

deactivate_code_discount

Deactivate a code discount

delete_code_discount

Delete a code discount by GID

Discounts — Automatic Discounts / GraphQL (11)

Modern Shopify GraphQL discount API for automatic discounts (applied without a code).

Tool

Description

list_automatic_discounts

List automatic discounts (paginated, optional search query)

get_automatic_discount

Get an automatic discount by GID

create_automatic_discount_basic

Create an amount-off automatic discount

update_automatic_discount_basic

Update an amount-off automatic discount

create_automatic_discount_bxgy

Create a Buy X Get Y automatic discount

update_automatic_discount_bxgy

Update a Buy X Get Y automatic discount

create_automatic_discount_free_shipping

Create a free-shipping automatic discount

update_automatic_discount_free_shipping

Update a free-shipping automatic discount

activate_automatic_discount

Activate an automatic discount

deactivate_automatic_discount

Deactivate an automatic discount

delete_automatic_discount

Delete an automatic discount by GID

Fulfillments (5)

Tool

Description

list_fulfillment_orders

List fulfillment orders for an order

list_fulfillments

List fulfillments for an order

create_fulfillment

Create a fulfillment with tracking info

update_fulfillment_tracking

Update tracking number/URL on a fulfillment

cancel_fulfillment

Cancel a fulfillment

Webhooks (5)

Tool

Description

list_webhooks

List all registered webhooks

get_webhook

Get a webhook by ID

create_webhook

Register a new webhook

update_webhook

Update a webhook callback URL (topic cannot be changed after creation)

delete_webhook

Remove a webhook

Menus (5)

Tool

Description

list_menus

List navigation menus

get_menu

Get a navigation menu by handle, including nested items

create_menu

Create a navigation menu

update_menu

Update a navigation menu

delete_menu

Delete a navigation menu

Files (5)

Tool

Description

list_files

List files in Shopify Files

create_file

Create a file from a staged upload or URL

update_file

Update file metadata

delete_files

Delete one or more files

stage_upload

Create a staged upload target

Apps (2)

Tool

Description

list_app_installations

List app installations

get_app_installation

Get an app installation by ID

Themes (10)

Tool

Description

list_themes

List online store themes

get_theme

Get a theme by ID

create_theme

Create a theme from a source URL

update_theme

Update theme metadata

publish_theme

Publish a theme

delete_theme

Delete a theme

list_theme_files

List files in a theme

get_theme_files

Read theme file contents

upsert_theme_files

Create or update theme files

delete_theme_files

Delete theme files

Pages (5)

Tool

Description

list_pages

List online store pages

get_page

Get a page by ID

create_page

Create a page

update_page

Update a page

delete_page

Delete a page

Bundles (4)

Tool

Description

create_bundle

Create a product bundle operation

update_bundle

Update a product bundle operation

get_bundle

Get a bundle product by ID

get_bundle_operation

Get a bundle operation by ID


Authentication

The server uses Shopify's client_credentials OAuth grant — no browser-based authorization needed. It automatically obtains and caches an access token on the first API call.

Required app scopes (configure in Shopify Admin → App → API access):

  • read_products, write_products

  • read_orders, write_orders

  • read_customers, write_customers

  • read_inventory, write_inventory

  • read_locations

  • read_draft_orders, write_draft_orders

  • read_discounts, write_discounts

  • read_shipping, write_shipping

  • read_fulfillments, write_fulfillments


Development

# Run directly with ts-node (reads .env automatically)
npm run dev

# Build to dist/
npm run build

# Run compiled version
npm start

Architecture

src/
├── index.ts              # MCP server entry — wires everything together
├── config.ts             # Environment variable loading & validation
├── auth.ts               # Token management (client_credentials grant)
├── shopify-client.ts     # Admin GraphQL HTTP client
└── tools/
    ├── shop.ts           # Store info
    ├── products.ts       # Products, product metafields, metafield definitions
    ├── images.ts         # Product images
    ├── variants.ts       # Product variants
    ├── collections.ts    # Custom & smart collections
    ├── orders.ts         # Orders & order metafields
    ├── customers.ts      # Customers & customer metafields
    ├── inventory.ts      # Locations & inventory levels
    ├── draft-orders.ts   # Draft orders
    ├── discounts.ts      # GraphQL code, automatic, and compatibility discount tools
    ├── fulfillments.ts   # Fulfillments & tracking
    └── webhooks.ts       # Webhook management

License

MIT

Available Tools

136 tools
activate_automatic_discountA

Activate an automatic discount that is currently inactive or scheduled.

Inputs: id (required).

activate_code_discountA

Activate a code discount that is currently inactive or scheduled.

Inputs: id (required).

add_product_to_collectionB

Add a product to a custom collection.

Inputs: product_id (required), collection_id (required).

adjust_inventoryA

Adjust inventory by a relative amount (positive to add stock, negative to remove). Requires the inventory_item_id (from a product variant) and location_id.

Inputs: inventory_item_id (required), location_id (required), adjustment (required).

cancel_fulfillmentB

Cancel a fulfillment. This restocks the items and sets the fulfillment status to cancelled.

Inputs: fulfillment_id (required).

cancel_orderA

Cancel an order. Optionally specify a reason and whether to send a notification email to the customer. This may also trigger a refund depending on restock and refund settings.

Inputs: order_id (required), reason, email, restock.

close_orderB

Close an order. Closed orders are considered completed and no longer active.

Inputs: order_id (required).

complete_draft_orderB

Complete a draft order, converting it into a real order. Optionally mark it as paid.

Inputs: draft_order_id (required), payment_pending.

create_automatic_discount_basicB

Create an automatic amount-off discount (percentage or fixed) that's applied without a code when cart meets criteria.

Inputs: title (required), startsAt (required), discountType (required), discountValue (required), +9 more.

create_automatic_discount_bxgyB

Create an automatic Buy X Get Y discount applied without a code.

Inputs: title (required), startsAt (required), buyQuantity (required), getQuantity (required), +11 more.

create_automatic_discount_free_shippingC

Create an automatic free shipping discount applied without a code when order meets criteria.

Inputs: title (required), startsAt (required), endsAt, destinationAll, +6 more.

create_bundleA

Create a fixed product bundle using the Shopify Bundles app. Groups multiple component products into a single parent product. The operation is asynchronous — use get_bundle_operation with the returned operation ID to poll until status is COMPLETE. Requires the Shopify Bundles app to be installed and write_products scope.

Inputs: title (required), components (required).

create_code_discount_basicA

Create an amount-off code discount (percentage or fixed) that customers apply at checkout. Supports product/collection targeting, minimum requirements, and combination rules.

Inputs: title (required), code (required), startsAt (required), discountType (required), +12 more.

create_code_discount_bxgyB

Create a Buy X Get Y (BXGY) code discount. Customers enter a code to get a discount when they buy specified items.

Inputs: title (required), code (required), startsAt (required), buyQuantity (required), +13 more.

create_code_discount_free_shippingC

Create a free shipping code discount. Customers enter a code to get free (or discounted) shipping.

Inputs: title (required), code (required), startsAt (required), endsAt, +9 more.

create_custom_collectionB

Create a new custom (manual) collection. Optionally include product IDs to add to it.

Inputs: title (required), body_html, published, sort_order, +2 more.

create_customerA

Create a new customer. At minimum provide an email. Optionally include name, phone, address, and tags.

Inputs: email, first_name, last_name, phone, +3 more.

create_discount_codeC

Set the customer-facing code for a basic GraphQL code discount node.

Inputs: price_rule_id (required), code (required).

create_draft_orderB

Create a new draft order. Provide line items (variant-based or custom), an optional customer, and shipping/billing addresses.

Inputs: line_items (required), customer_id, email, note, +4 more.

create_fileB

Create a file asset in the store from an external URL or a staged upload URL. Supports images, videos, 3D models, and generic files. Requires write_files access scope.

Inputs: original_source (required), alt, content_type, duplicate_resolution_mode.

create_fulfillmentB

Create a fulfillment for one or more fulfillment orders. This marks items as shipped and optionally adds tracking info.

Inputs: fulfillment_order_ids (required), tracking_number, tracking_url, tracking_company, +1 more.

create_menuA

Create a new navigation menu for the online store. Requires write_online_store_navigation access scope.

Inputs: title (required), handle (required), items (required).

create_metafield_definitionA

Create a new metafield definition for products at the store level. Definitions establish structure and validation rules (e.g. allowed choices) for metafields. Use validations to set constraints like allowed choices for text fields.

Inputs: name (required), key (required), type (required), namespace, +4 more.

create_pageA

Create a new online store page (e.g. About Us, Contact, policy pages). Requires write_content or write_online_store_pages access scope.

Inputs: title (required), body, handle, is_published, +2 more.

create_price_ruleB

Create a modern basic code discount through GraphQL. Preserves the legacy price-rule tool name for compatibility.

Inputs: title (required), target_type (required), target_selection (required), allocation_method (required), +7 more.

create_productA

Create a new product. At minimum provide a title. The product is created in 'draft' status by default. Variants can be provided to set prices, SKUs, and inventory. Note: images and variants are added in follow-up calls after the product is created; if one of those steps fails, the product still exists and the error message includes its ID so you can fix it with update tools.

Inputs: title (required), body_html, vendor, product_type, +4 more.

create_product_imageB

Add an image to a product by URL. Optionally assign it to specific variants.

Inputs: product_id (required), src (required), alt, position, +1 more.

create_smart_collectionA

Create a new smart (automatic) collection with rules that determine which products are included.

Inputs: title (required), body_html, published, disjunctive, +2 more.

create_themeA

Create a new theme from a public ZIP URL or a staged upload URL. New themes are UNPUBLISHED by default. Requires write_themes access scope.

Inputs: source (required), name, role.

create_variantA

Create a new variant for a product. Must specify at least one option value.

Inputs: product_id (required), option1, option2, option3, +9 more.

create_webhookA

Create a new webhook subscription. Common topics: orders/create, orders/updated, products/create, products/update, customers/create, app/uninstalled.

Inputs: topic (required), address (required), format.

deactivate_automatic_discountA

Deactivate (pause) an automatic discount without deleting it.

Inputs: id (required).

deactivate_code_discountA

Deactivate (pause) a code discount without deleting it.

Inputs: id (required).

delete_automatic_discountA

Permanently delete an automatic discount by its GID. This cannot be undone.

Inputs: id (required).

delete_code_discountA

Permanently delete a code discount by its GID. This cannot be undone.

Inputs: id (required).

delete_custom_collectionA

Permanently delete a custom collection. Products in it are NOT deleted.

Inputs: collection_id (required).

delete_customer_metafieldA

Delete a customer metafield by its GID or numeric ID.

Inputs: metafield_id (required).

delete_discount_codeB

Delete a redeem code from a GraphQL code discount node.

Inputs: price_rule_id (required), discount_code_id (required).

delete_draft_orderA

Permanently delete a draft order. Cannot delete completed draft orders.

Inputs: draft_order_id (required).

delete_filesA

Permanently delete one or more files by their GIDs. This cannot be undone. Requires write_files access scope.

Inputs: file_ids (required).

delete_menuA

Delete a navigation menu. Default menus (e.g. main-menu, footer-menu) cannot be deleted. Requires write_online_store_navigation access scope.

Inputs: id (required).

delete_order_metafieldA

Delete an order metafield by its GID or numeric ID.

Inputs: metafield_id (required).

delete_pageA

Permanently delete an online store page. This cannot be undone. Requires write_content or write_online_store_pages access scope.

Inputs: page_id (required).

delete_price_ruleC

Delete a code discount by DiscountCodeNode ID. Preserves the legacy price-rule tool name for compatibility.

Inputs: price_rule_id (required).

delete_productA

Permanently delete a product by its ID. This cannot be undone.

Inputs: product_id (required).

delete_product_imageB

Delete an image from a product.

Inputs: product_id (required), image_id (required).

delete_product_metafieldA

Permanently delete a metafield by its GID. This cannot be undone.

Inputs: metafield_id (required).

delete_themeA

Delete a theme. The active (MAIN) theme cannot be deleted. Requires write_themes access scope and a Shopify exemption.

Inputs: theme_id (required).

delete_theme_filesC

Delete one or more files from a theme by filename. Requires write_themes access scope.

Inputs: theme_id (required), filenames (required).

delete_variantA

Delete a product variant. A product must always have at least one variant.

Inputs: product_id (required), variant_id (required).

delete_webhookB

Delete a webhook subscription.

Inputs: webhook_id (required).

get_app_installationA

Get details of a specific app installation by its GID, including access scopes and active subscriptions.

Inputs: installation_id (required).

get_automatic_discountA

Get an automatic discount by its GID (e.g. 'gid://shopify/DiscountAutomaticNode/123').

Inputs: id (required).

get_bundleA

Get full details of a bundle product including its component products, quantities, and option mappings. Uses GraphQL to fetch bundleComponents, which exposes the bundle structure.

Inputs: product_id (required).

get_bundle_operationA

Poll the status of an asynchronous bundle create or update operation. Status values: CREATED (queued), ACTIVE (in progress), COMPLETE (done — product is ready). Call this after create_bundle or update_bundle until status is COMPLETE. Requires read_products scope.

Inputs: operation_id (required).

get_code_discountA

Get a code discount by its GID (e.g. 'gid://shopify/DiscountCodeNode/123') or by the code string customers enter at checkout.

Inputs: id, code.

get_custom_collectionA

Get full details of a single custom collection by its ID.

Inputs: collection_id (required).

get_customerA

Get full details of a single customer by their ID, including addresses, order count, and total spent.

Inputs: customer_id (required).

get_customer_metafieldB

Get a single customer metafield by namespace and key.

Inputs: customer_id (required), namespace (required), key (required).

get_draft_orderA

Get full details of a single draft order by its ID.

Inputs: draft_order_id (required).

get_locationA

Get details of a single location by its ID.

Inputs: location_id (required).

get_menuA

Get a navigation menu by its handle, including its full nested item structure.

Inputs: handle (required).

get_orderA

Get full details of a single order by its ID, including line items, shipping address, fulfillments, and transactions.

Inputs: order_id (required).

get_order_metafieldA

Get a single order metafield by namespace and key.

Inputs: order_id (required), namespace (required), key (required).

get_pageA

Get full details of a single online store page by its ID, including body HTML. Requires read_content or read_online_store_pages access scope.

Inputs: page_id (required).

get_price_ruleC

Get a code discount by DiscountCodeNode ID. This compatibility tool replaces the older Price Rules workflow.

Inputs: price_rule_id (required).

get_productA

Get full details of a single product by its ID, including all variants, images, and options.

Inputs: product_id (required).

get_product_imageB

Get details of a single product image.

Inputs: product_id (required), image_id (required).

get_product_metafieldA

Get a single metafield by namespace and key for a given product via GraphQL. Uses jsonValue for proper serialization.

Inputs: product_id (required), namespace (required), key (required).

get_shop_infoA

Get basic information about the Shopify store: name, domain, email, plan, currency, timezone, and more.

Inputs: no named parameters.

get_smart_collectionA

Get full details of a single smart collection by its ID, including its rules.

Inputs: collection_id (required).

get_themeA

Get details of a single theme by its GID. Requires read_themes access scope.

Inputs: theme_id (required).

get_theme_filesA

Get one or more specific theme files by their filenames, including their full content. Requires read_themes access scope.

Inputs: theme_id (required), filenames (required).

get_variantB

Get full details of a single product variant by its ID.

Inputs: variant_id (required).

get_webhookB

Get details of a single webhook subscription.

Inputs: webhook_id (required).

list_app_installationsB

List apps installed on the store. Returns details about each app installation including the app name, access scopes granted, and active subscriptions.

Inputs: limit, after, category, sort_key, +1 more.

list_automatic_discountsA

List automatic discounts (applied without a code) using the GraphQL API. Supports filtering by status, type, and text search.

Inputs: limit, after, query.

list_code_discountsB

List code discounts using the GraphQL API. Returns basic, BXGY, and free shipping code discounts. Supports filtering by status, type, and text search.

Inputs: limit, after, query.

list_collection_productsA

List all products belonging to a specific collection (custom or smart).

Inputs: collection_id (required), limit, page_info.

list_custom_collectionsA

List custom (manual) collections. These are collections where the merchant manually selects which products to include.

Inputs: limit, since_id, title, product_id, +1 more.

list_customer_metafieldsB

List all metafields for a customer via GraphQL.

Inputs: customer_id (required), namespace, limit.

list_customersB

List customers in the store. Supports pagination and basic filtering by creation date.

Inputs: limit, since_id, created_at_min, created_at_max, +1 more.

list_discount_codesC

List redeem codes for a GraphQL code discount node.

Inputs: price_rule_id (required), limit, page_info.

list_draft_ordersC

List draft orders in the store. Draft orders can be used to create orders on behalf of customers.

Inputs: limit, status, since_id, page_info.

list_filesA

List files uploaded to the store (images, videos, documents, etc.). Supports filtering by media type, filename, status, and more. Requires read_files access scope.

Inputs: limit, after, query, sort_key, +1 more.

list_fulfillment_ordersA

List fulfillment orders for an order. Fulfillment orders represent groups of items to be fulfilled from a specific location.

Inputs: order_id (required).

list_fulfillmentsA

List all fulfillments for an order, including tracking info and status.

Inputs: order_id (required), limit, page_info.

list_inventory_levelsA

List inventory levels (stock quantities) for a given location. Returns available quantities for each inventory item at that location.

Inputs: location_id (required), limit, page_info.

list_locationsA

List all locations (warehouses, stores, etc.) configured for this Shopify store. Each location has an ID used for inventory operations.

Inputs: no named parameters.

list_menusB

List all navigation menus in the store via GraphQL.

Inputs: limit.

list_metafield_definitionsA

List all metafield definitions for products at the store level. Returns namespace, key, type, name, description, and validations via GraphQL.

Inputs: namespace.

list_order_metafieldsB

List all metafields for an order via GraphQL.

Inputs: order_id (required), namespace, limit.

list_ordersB

List orders in the store. By default returns open orders. Use status to filter by fulfillment status, and financial_status for payment status. Results are paginated.

Inputs: limit, status, financial_status, fulfillment_status, +4 more.

list_pagesA

List online store pages (e.g. About Us, Contact, policy pages). Supports filtering by title, handle, published status, and date ranges. Requires read_content or read_online_store_pages access scope.

Inputs: limit, after, query, sort_key, +1 more.

list_price_rulesC

List code discounts using the Admin GraphQL API. This compatibility tool replaces the older Price Rules workflow.

Inputs: limit, since_id, page_info.

list_product_imagesB

List all images for a product.

Inputs: product_id (required), limit, page_info.

list_product_metafieldsA

List all metafields attached to a product via GraphQL. Returns key, namespace, type, jsonValue, and more. Optionally filter by namespace.

Inputs: product_id (required), namespace, limit.

list_productsA

List products in the store. Returns up to limit products, with optional filtering by status, title, vendor, product_type, or collection_id. Use page_info for cursor-based pagination.

Inputs: limit, status, title, vendor, +3 more.

list_smart_collectionsC

List smart (automatic) collections. These are collections where products are automatically included based on rules.

Inputs: limit, since_id, title, product_id, +1 more.

list_theme_filesA

List all files in a theme (templates, assets, sections, snippets, config, locales). Requires read_themes access scope.

Inputs: theme_id (required), limit, after.

list_themesA

List all themes installed on the online store. Filter by role to find the published (MAIN) theme, unpublished themes, or development themes. Requires read_themes access scope.

Inputs: limit, roles.

list_variantsA

List all variants of a product. Each variant represents a specific purchasable SKU with its own price, inventory, and options.

Inputs: product_id (required), limit, page_info.

list_webhooksB

List all webhook subscriptions for this app.

Inputs: limit, topic, page_info.

publish_themeA

Publish a theme, making it the live storefront theme (MAIN role). Requires write_themes access scope and a Shopify exemption for theme modification.

Inputs: theme_id (required).

remove_product_from_collectionB

Remove a product from a custom collection.

Inputs: product_id (required), collection_id (required).

reorder_collection_productsA

Reorder products in a custom collection. Provide an ordered array of product IDs. The collection's sort_order must be 'manual' for positions to be honoured on the storefront.

Inputs: collection_id (required), product_ids (required).

search_customersA

Search for customers using a query string. Supports Shopify search syntax (e.g. 'email:john@example.com', 'country:US', or just a name).

Inputs: query (required), limit.

send_draft_order_invoiceB

Send an invoice email for a draft order with a secure checkout link.

Inputs: draft_order_id (required), to, from, subject, +1 more.

set_customer_metafieldA

Create or update a customer metafield using metafieldsSet (upsert).

Inputs: customer_id (required), key (required), value (required), namespace, +1 more.

set_inventoryA

Set inventory to an absolute quantity at a given location. This overwrites the current available quantity.

Inputs: inventory_item_id (required), location_id (required), available (required).

set_order_metafieldB

Create or update an order metafield using metafieldsSet (upsert).

Inputs: order_id (required), key (required), value (required), namespace, +1 more.

set_product_metafieldA

Create or update a metafield on a product using the GraphQL metafieldsSet mutation (upsert). If the metafield exists it will be updated; otherwise created. Use type only when creating a new metafield.

Inputs: product_id (required), key (required), value (required), namespace, +1 more.

stage_uploadA

Generate a pre-signed staged upload target for a file. This is step 1 of Shopify's two-step upload flow: (1) call this tool to get upload URL and parameters, (2) PUT/POST the file binary to that URL using the returned parameters as form fields or headers, (3) call create_file with the returned resourceUrl (not url) as original_source. Requires write_files access scope.

Inputs: filename (required), mime_type (required), resource (required), file_size, +1 more.

update_automatic_discount_basicB

Update an existing basic automatic discount. Only provided fields are changed.

Inputs: id (required), title, startsAt, endsAt, +10 more.

update_automatic_discount_bxgyC

Update an existing automatic BXGY discount. Only provided fields are changed.

Inputs: id (required), title, startsAt, endsAt, +12 more.

update_automatic_discount_free_shippingC

Update an existing automatic free shipping discount. Only provided fields are changed.

Inputs: id (required), title, startsAt, endsAt, +7 more.

update_bundleA

Update an existing product bundle. Providing components replaces ALL current components — omit components to leave them unchanged. The operation is asynchronous — use get_bundle_operation with the returned operation ID to poll until status is COMPLETE. Requires write_products scope.

Inputs: product_id (required), title, components.

update_code_discount_basicC

Update an existing basic (amount-off) code discount. Only provided fields are changed.

Inputs: id (required), title, code, startsAt, +13 more.

update_code_discount_bxgyC

Update an existing BXGY code discount. Only provided fields are changed.

Inputs: id (required), title, code, startsAt, +14 more.

update_code_discount_free_shippingC

Update an existing free shipping code discount. Only provided fields are changed.

Inputs: id (required), title, code, startsAt, +10 more.

update_custom_collectionB

Update an existing custom collection. Only provided fields are changed.

Inputs: collection_id (required), title, body_html, published, +1 more.

update_customerA

Update an existing customer. Only provided fields are changed; omitted fields remain unchanged.

Inputs: customer_id (required), email, first_name, last_name, +3 more.

update_draft_orderA

Update an existing draft order. Only provided fields are changed.

Inputs: draft_order_id (required), note, tags, email, +1 more.

update_fileA

Update a file's alt text, filename, or content (by providing a new source URL). The file must be in READY state. Requires write_files access scope.

Inputs: id (required), alt, filename, original_source.

update_fulfillment_trackingB

Update tracking information for an existing fulfillment.

Inputs: fulfillment_id (required), tracking_number, tracking_url, tracking_company, +1 more.

update_menuA

Update an existing navigation menu's title, handle, and items. Requires write_online_store_navigation access scope.

Inputs: id (required), title (required), items (required), handle.

update_orderA

Update an existing order. Typically used to add/edit notes or tags. Only provided fields are changed.

Inputs: order_id (required), note, tags, email.

update_pageA

Update an existing online store page. Only provided fields are changed. Requires write_content or write_online_store_pages access scope.

Inputs: page_id (required), title, body, handle, +3 more.

update_price_ruleB

Update a modern basic code discount through GraphQL. Preserves the legacy price-rule tool name for compatibility.

Inputs: price_rule_id (required), title, value, starts_at, +3 more.

update_productA

Update an existing product. Only provided fields are changed; omitted fields remain unchanged.

Inputs: product_id (required), title, body_html, vendor, +3 more.

update_product_imageA

Update a product image (change alt text, position, or variant assignments).

Inputs: product_id (required), image_id (required), alt, position, +1 more.

update_smart_collectionB

Update a smart (automatic) collection's sort order or other metadata. Only provided fields are changed.

Inputs: collection_id (required), title, body_html, sort_order.

update_themeA

Update a theme's name. Requires write_themes access scope.

Inputs: theme_id (required), name (required).

update_variantA

Update an existing product variant. Only provided fields are changed.

Inputs: variant_id (required), price, compare_at_price, sku, +8 more.

update_webhookA

Update an existing webhook subscription's callback URL. The topic cannot be changed after creation; delete and recreate the webhook to change topics.

Inputs: webhook_id (required), address.

upsert_theme_filesA

Create or update theme files (up to 50 per request). Provide file content as text or base64. Requires write_themes access scope.

Inputs: theme_id (required), files (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 136 tools

    Disambiguation2/5

    Many tools have overlapping purposes, particularly around discounts (automatic vs code, basic/BXGY/free shipping) and legacy price_rule tools. Agents may struggle to choose the correct tool among 6 create discount tools, leading to misselection.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (create, list, get, update, delete). However, legacy tools like create_price_rule break consistency with the newer discount tools, and 'stage_upload' is a different pattern.

    Tool Count1/5

    136 tools is far too many for a coherent server. This granularity exposes nearly every API endpoint, overwhelming agents. Typical well-scoped servers have 3-15 tools; this server has over 10 times that.

    Completeness4/5

    The tool set covers a wide range of Shopify resources (products, orders, customers, discounts, themes, files, etc.) with full CRUD for most. Minor gaps exist (no explicit refund tool, no bulk operations), but overall it's comprehensive.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      A production-grade MCP server and CLI tool that enables AI agents to manage Shopify stores through 49 built-in tools across products, orders, inventory, and analytics. It supports natural language workflows for tasks like inventory tracking, customer support, and sales reporting.
      19
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.
      19 npm
      20
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A Model Context Protocol server that connects AI agents to the Shopify Admin GraphQL API, enabling management of products, orders, customers, and more through natural language.
      19 npm
      6
      MIT