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
--port	MCP_PORT	9110	Bind port
--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

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

... View full README on GitHub