@miller-joe/shopify-mcp

shopify-mcp

MCP server for Shopify. Full Admin GraphQL API tooling plus an AI-driven product creation bridge via ComfyUI image generation.

The pitch

Every other Shopify MCP is a plain Admin API wrapper. This one pairs with @miller-joe/comfyui-mcp so you can say things like:

"Create a product called 'Nebula Dreamer'. Generate a cosmic abstract image for it, description matching the vibe, tagged astrology, status draft."

Claude then runs ComfyUI, gets an image back, creates the Shopify product, and attaches the image, all in one call.

Install

# npx, no install
npx @miller-joe/shopify-mcp \
  --shopify-store your-store.myshopify.com \
  --shopify-access-token shpat_xxx

# Docker
docker run -p 9110:9110 \
  -e SHOPIFY_STORE=your-store.myshopify.com \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxx \
  -e COMFYUI_URL=http://comfyui:8188 \
  ghcr.io/miller-joe/shopify-mcp:latest

Connect an MCP client

claude mcp add --transport http shopify http://localhost:9110/mcp

Or point your MCP gateway at the Streamable HTTP endpoint.

Configuration

CLI flag	Env var	Default	Notes
--shopify-store	SHOPIFY_STORE	(required)	my-store or my-store.myshopify.com
--shopify-access-token	SHOPIFY_ACCESS_TOKEN	(required)	Admin API token (shpat_…)
--shopify-api-version	SHOPIFY_API_VERSION	2026-04	GraphQL Admin API version
--host	MCP_HOST	0.0.0.0	Bind host (HTTP mode only)
--port	MCP_PORT	9110	Bind port (HTTP mode only)
--stdio	MCP_TRANSPORT=stdio	(unset)	Speak MCP over stdio instead of HTTP. Use when launched as a subprocess by a stdio-first MCP client (Claude Desktop, mcp-inspector).
--comfyui-url	COMFYUI_URL	(optional)	Enables bridge tools when set
--comfyui-public-url	COMFYUI_PUBLIC_URL	same as --comfyui-url	External URL used for image references passed to Shopify
(no flag)	COMFYUI_DEFAULT_CKPT	sd_xl_base_1.0.safetensors	Default checkpoint for bridge tools

Transports

The server speaks streamable HTTP by default (great for Claude Code, MetaMCP, raw fetch). Pass --stdio (or set MCP_TRANSPORT=stdio) to switch into stdio mode, which is what stdio-first clients like Claude Desktop and the MCP Inspector expect:

// claude_desktop_config.json
{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "@miller-joe/shopify-mcp", "--stdio"],
      "env": {
        "SHOPIFY_STORE": "my-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_…"
      }
    }
  }
}

Getting a Shopify access token

Easy path, existing dev store: Shopify Admin → Apps → Develop apps → Create custom app → enable relevant Admin API scopes (write_products, read_orders, write_inventory, read_customers) → install → copy the admin API access token (starts with shpat_).

For new apps (post-Jan 2026): legacy custom-app tokens are deprecated for freshly-created apps. Use the Dev Dashboard token-exchange flow once to obtain a working token, then supply it here. Multi-tenant OAuth is on the roadmap.

Tools

Core Admin

Tool	Description
list_products	Paginated product search with Shopify query syntax
get_product	Fetch one product with variants, images, media
create_product	Create a product (default DRAFT); optionally attach images
update_product	Update title, description, tags, status, etc.
upload_product_image	Attach a public image URL to an existing product
list_orders	List orders, newest first, with query filters
get_order	Fetch one order with line items
set_inventory_quantity	Set absolute on-hand inventory at a location
list_locations	List store locations (for inventory ops)
list_customers	List customers with query filters

Metafields

Tool	Description
set_metafield	Upsert a metafield on any HasMetafields resource (product, variant, collection, customer, order, shop, etc.)
list_metafields	List metafields for a resource, optionally filtered by namespace
delete_metafield	Delete a metafield by (ownerId, namespace, key)

Draft orders

Tool	Description
list_draft_orders	List draft orders with Shopify query filters
get_draft_order	Fetch one draft order with its line items
create_draft_order	Create a draft order. Line items can be variant refs or custom (title + price).
update_draft_order	Update customer, line items, tags, note, email
complete_draft_order	Convert a draft order to a real order. paymentPending skips capture.
delete_draft_order	Delete a non-completed draft order

Webhooks

Tool	Description
list_webhooks	List webhook subscriptions; filter by topic(s)
get_webhook	Fetch a single subscription
create_webhook	Subscribe an HTTPS callback URL to a topic (e.g. ORDERS_CREATE)
update_webhook	Change callback URL, format, or field/metafield filters
delete_webhook	Delete a subscription

Metaobjects

Tool	Description
list_metaobject_definitions	Discover metaobject types (schemas) on the store, including field definitions
list_metaobjects	List metaobjects of a given type
get_metaobject	Fetch one metaobject with all its fields
create_metaobject	Create a metaobject (type must already exist as a definition). Supports ACTIVE/DRAFT status.
update_metaobject	Upsert fields, change handle, toggle publishable status
delete_metaobject	Delete a metaobject

Fulfillment

Tool	Description
list_fulfillment_orders	List an order's fulfillment orders (one per shipping location), with remaining quantities per line item
get_fulfillment_order	Fetch a single fulfillment order
get_fulfillment	Fetch a single fulfillment (shipment record) with tracking info
create_fulfillment	Mark fulfillment orders (or specific quantities) as fulfilled. Optionally attach tracking and notify the customer.
update_fulfillment_tracking	Update carrier/number/url on an existing fulfillment
cancel_fulfillment	Cancel a fulfillment by ID

Partial fulfillment is supported. Pass specific fulfillmentOrderLineItems with quantity per line, or omit the array to fulfill everything on the fulfillment order.

Variants and product options

Tool	Description
list_variants	List all variants of a product with selected options, price, SKU, inventory
create_variants	Bulk-create variants (up to 100) with option values, price, SKU, compareAtPrice, initial inventory
update_variants	Bulk-update variant price, compareAtPrice, SKU, barcode, taxable, inventoryPolicy, option values
delete_variants	Bulk-delete variants from a product
reorder_variants	Set 1-indexed positions for variants
add_product_options	Add options (Size / Color / etc.) with their possible values. Up to 3 options per product.

For an entirely new product, creating the first real variant requires strategy="REMOVE_STANDALONE_VARIANT" to replace the auto-generated "Default Title" variant.

Collections and tagging

Tool	Description
list_collections	List collections with query filters
get_collection	Fetch one collection with its products
create_collection	Create a manual collection, optionally seeded with products
update_collection	Update title, description, or handle
delete_collection	Delete a collection
add_products_to_collection	Add products to a manual collection (async job on Shopify's side)
remove_products_from_collection	Remove products from a manual collection
add_tags	Add tags to any taggable resource (Product, Order, Customer, DraftOrder, Collection)
remove_tags	Remove tags from a taggable resource

Analytics (ShopifyQL)

Tool	Description
run_shopifyql_query	Run a ShopifyQL query and render the result as an ASCII table. Pass raw=true for the raw JSON payload.

Examples:

• FROM sales SHOW total_sales BY day SINCE -30d TIMESERIES
• FROM products SHOW product_title, quantity_sold BY product_id SINCE -7d ORDER BY quantity_sold DESC LIMIT 10

ComfyUI bridge (when COMFYUI_URL is configured)

Tool	Description
generate_and_create_product	Generate an image and create a product with it, in one call. Title and description derive from the prompt if not given.
generate_product_image	Generate an image and attach it to an existing product.
refine_product_image	Run img2img on a product's featured image (or an explicit URL) and attach the refined result. Tune denoise (0–1) for how far the result drifts from the source.
bulk_regenerate_images	For all products matching a query, run the generator with a templated prompt and attach fresh images.

Template placeholders for bulk_regenerate_images: {title}, {handle}.

Example: the whole pitch in one call

Claude, use generate_and_create_product:
  prompt: "minimalist sunset mountain silhouette, warm gradient, vector style"
  title: "Mountain Sunset Poster"
  status: DRAFT
  tags: ["posters", "nature", "minimalist"]

ComfyUI generates the image, Shopify creates the product with the image attached, and you get the product ID and image URL back. One prompt, one call, real listing.

Architecture

┌────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  MCP client    │────▶│  shopify-mcp     │────▶│  Shopify Admin  │
│  (Claude etc.) │◀────│  (this server)   │◀────│  GraphQL API    │
└────────────────┘     └────────┬─────────┘     └─────────────────┘
                                │
                                │ (bridge tools only)
                                ▼
                       ┌──────────────────┐
                       │  ComfyUI         │
                       │  (txt2img)       │
                       └──────────────────┘

Bridge tools call ComfyUI directly over HTTP, get an image URL, and pass it to Shopify's productCreateMedia mutation. Shopify fetches and hosts the image on its CDN.

Development

git clone https://github.com/miller-joe/shopify-mcp
cd shopify-mcp
npm install
npm run dev   # hot reload via tsx watch
npm run build
npm run typecheck
npm test

Requires Node 20+.

Roadmap

Shipped:

• Core products CRUD plus image attach
• Orders read, Inventory set + locations, Customers read
• ComfyUI bridge: generate_and_create_product, generate_product_image, bulk_regenerate_images
• Metafields: set_metafield, list_metafields, delete_metafield
• Draft orders: create / update / complete / delete / list / get
• Collections and tagging: CRUD, product add/remove, add_tags / remove_tags
• Variants and product options: bulk create / update / delete / reorder plus add_product_options
• Fulfillment: list/get fulfillment orders, create fulfillment (partial supported), update tracking, cancel
• Webhooks: list / get / create / update / delete
• Metaobjects: definitions list plus metaobject CRUD
• ShopifyQL analytics: run_shopifyql_query with ASCII-table rendering
• Image refinement bridge: refine_product_image (ComfyUI img2img on product images)

Planned:

• OAuth token-exchange flow for new-app auth.

License

MIT © Joe Miller

Support

If this saves you time, consider supporting development: