Kockatoos Shopify MCP Server
Provides tools to manage Shopify store resources including products, orders, customers, collections, discounts, and more via the Shopify Admin API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kockatoos Shopify MCP Server list products with low inventory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kockatoos Shopify MCP Server
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-mcpOr run directly with npx (no install needed):
npx @kockatoos/shopify-mcpRelated 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)
Go to Shopify Admin → Settings → Apps and sales channels → Develop apps
Create an app, configure the required Admin API scopes, and click Install app
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-tokenBefore running: add
http://localhost:3456/callbackto 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 buildThen 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 |
| Yes | Your store subdomain (e.g. |
| Yes* | Permanent access token (from admin-created app or Partner Dashboard OAuth flow) |
| No | API version (defaults to |
*
SHOPIFY_CLIENT_ID+SHOPIFY_CLIENT_SECRETcan be used instead ofSHOPIFY_ACCESS_TOKENonly for admin-created custom apps (store-only, no Partner Dashboard support).
Available Tools (136)
Shop (1)
Tool | Description |
| Get store name, domain, email, plan, currency, timezone |
Products (11)
Tool | Description |
| List products with filters (status, vendor, type) and pagination |
| Get full product details including variants and images |
| Create a product with title, description, variants, images |
| Update product fields (title, description, status, tags, etc.) |
| Permanently delete a product by ID |
| List all metafields for a product (GraphQL) |
| Get a product metafield by namespace and key (GraphQL) |
| Create or update a product metafield via |
| Delete a product metafield (GraphQL) |
| List all product metafield definitions with validations (GraphQL) |
| Create a new metafield definition for products (or other resource types) with validation rules (GraphQL) |
Product Images (5)
Tool | Description |
| List all images for a product |
| Get a specific product image |
| Add an image to a product by URL, with optional position and variant assignment |
| Update image alt text, position, or variant assignments |
| Remove an image from a product |
Variants (5)
Tool | Description |
| List all variants of a product |
| Get a specific variant |
| Add a new variant to a product |
| Update variant price, SKU, inventory, etc. |
| Remove a variant from a product |
Collections (13)
Tool | Description |
| List custom (manual) collections |
| List smart (automated) collections |
| Get a custom collection by ID |
| Get a smart collection by ID |
| Create a manual collection |
| Create an automated collection with rules |
| Update a custom collection |
| Delete a custom collection |
| Update a smart collection |
| Reorder products in a manual collection |
| Add a product to a custom collection |
| Remove a product from a custom collection |
| List all products in a collection |
Orders (9)
Tool | Description |
| List orders with filters (status, financial status, date range) |
| Get full order details (line items, shipping, transactions) |
| Update order notes, tags, or email |
| Mark an order as closed/completed |
| Cancel an order with optional reason, email notification, restock |
| List all metafields for an order (GraphQL) |
| Get an order metafield by namespace and key (GraphQL) |
| Create or update an order metafield via |
| Delete an order metafield (GraphQL) |
Customers (9)
Tool | Description |
| List customers with pagination |
| Search by email, name, country, etc. |
| Get full customer details and addresses |
| Create a customer with email, name, phone, addresses |
| Update customer fields |
| List all metafields for a customer (GraphQL) |
| Get a customer metafield by namespace and key (GraphQL) |
| Create or update a customer metafield via |
| Delete a customer metafield (GraphQL) |
Inventory (5)
Tool | Description |
| List all warehouse/store locations |
| Get details of a specific location |
| Get stock quantities at a location |
| Adjust stock by a relative amount (+/-) |
| Set stock to an absolute quantity |
Draft Orders (7)
Tool | Description |
| List draft orders with pagination |
| Get a draft order by ID |
| Create a new draft order with line items |
| Update a draft order |
| Convert a draft order into a real order |
| Email the draft order invoice to the customer |
| 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 code discounts through the compatibility wrapper |
| Get a code discount by DiscountCodeNode ID |
| Create a basic code discount |
| Update a basic code discount |
| Delete a code discount |
| List redeem codes for a code discount |
| Set the code on a basic code discount |
| 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 (paginated, optional search query) |
| Get a code discount by GID or by code string |
| Create an amount-off code discount |
| Update an amount-off code discount |
| Create a Buy X Get Y code discount |
| Update a Buy X Get Y code discount |
| Create a free-shipping code discount |
| Update a free-shipping code discount |
| Activate a code discount |
| Deactivate a 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 (paginated, optional search query) |
| Get an automatic discount by GID |
| Create an amount-off automatic discount |
| Update an amount-off automatic discount |
| Create a Buy X Get Y automatic discount |
| Update a Buy X Get Y automatic discount |
| Create a free-shipping automatic discount |
| Update a free-shipping automatic discount |
| Activate an automatic discount |
| Deactivate an automatic discount |
| Delete an automatic discount by GID |
Fulfillments (5)
Tool | Description |
| List fulfillment orders for an order |
| List fulfillments for an order |
| Create a fulfillment with tracking info |
| Update tracking number/URL on a fulfillment |
| Cancel a fulfillment |
Webhooks (5)
Tool | Description |
| List all registered webhooks |
| Get a webhook by ID |
| Register a new webhook |
| Update a webhook callback URL (topic cannot be changed after creation) |
| Remove a webhook |
Menus (5)
Tool | Description |
| List navigation menus |
| Get a navigation menu by handle, including nested items |
| Create a navigation menu |
| Update a navigation menu |
| Delete a navigation menu |
Files (5)
Tool | Description |
| List files in Shopify Files |
| Create a file from a staged upload or URL |
| Update file metadata |
| Delete one or more files |
| Create a staged upload target |
Apps (2)
Tool | Description |
| List app installations |
| Get an app installation by ID |
Themes (10)
Tool | Description |
| List online store themes |
| Get a theme by ID |
| Create a theme from a source URL |
| Update theme metadata |
| Publish a theme |
| Delete a theme |
| List files in a theme |
| Read theme file contents |
| Create or update theme files |
| Delete theme files |
Pages (5)
Tool | Description |
| List online store pages |
| Get a page by ID |
| Create a page |
| Update a page |
| Delete a page |
Bundles (4)
Tool | Description |
| Create a product bundle operation |
| Update a product bundle operation |
| Get a bundle product by ID |
| 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_productsread_orders,write_ordersread_customers,write_customersread_inventory,write_inventoryread_locationsread_draft_orders,write_draft_ordersread_discounts,write_discountsread_shipping,write_shippingread_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 startArchitecture
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 managementLicense
MIT
Available Tools
136 toolsactivate_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_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_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_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_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_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
Scored across 136 tools
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.
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.
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.
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
Related MCP Connectors
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceA 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.-
- AlicenseNot gradedqualityBmaintenanceA 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.19MIT
- AlicenseNot gradedqualityCmaintenanceA comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.19 npm20MIT
- AlicenseNot gradedqualityBmaintenanceA 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 npm6MIT