What can you do with this server?

The shopify-mcp server provides comprehensive Shopify Admin API management, enabling full CRUD operations across core Shopify resources, plus optional AI-driven product image generation via ComfyUI. Products & Variants * List, get, create, update, delete products; upload/attach images * Manage variants: bulk create/update/delete, reorder, add options (Size, Color, etc.) Orders * List and retrieve orders with line items Draft Orders * List, get, create, update, complete, and delete draft orders Customers * List customers with query filters Inventory & Locations * Set absolute on-hand inventory at a specific location; list store locations Metafields * Upsert, list, and delete metafields on any supported resource (products, variants, collections, customers, orders, shop) Collections & Tagging * Full CRUD for collections; add/remove products from manual collections; add/remove tags on any taggable resource Webhooks * List, get, create, update, and delete webhook subscriptions Metaobjects * Discover metaobject definitions; list, get, create, update, and delete metaobjects Fulfillment * List/get fulfillment orders and fulfillment records; create fulfillments (partial supported, with tracking and customer notifications); update tracking; cancel fulfillments Analytics * Run ShopifyQL queries, returning results as ASCII tables or raw JSON ComfyUI Bridge (requires COMFYUI_URL configured) * Generate an AI image and create a new Shopify product in one call * Generate an AI image and attach it to an existing product * Refine a product's featured image via img2img * Bulk regenerate images for all products matching a query

Which integrations are available for this server?

Provides comprehensive Shopify Admin API integration with tools for product management, inventory control, order fulfillment, customer management, collections, webhooks, metafields, draft orders, and analytics through ShopifyQL queries.

de en es ja ko ru zh

shopify-mcp

by miller-joe

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

shopify-mcp

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

shopify-mcp MCP server

GitHub Sponsors Ko-fi

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.

Related MCP server: comfyui-mcp

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

Support

If this saves you time, consider supporting development:

GitHub Sponsors Ko-fi

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Resources

Need Help?

Related Servers

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/miller-joe/shopify-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

shopify-mcp

The pitch

Install

Connect an MCP client

Configuration

Transports

Getting a Shopify access token

Tools

Core Admin

Metafields

Draft orders

Webhooks

Metaobjects

Fulfillment

Variants and product options

Collections and tagging

Analytics (ShopifyQL)

ComfyUI bridge (when COMFYUI_URL is configured)

Example: the whole pitch in one call

Architecture

Development

Roadmap

License

Support

Maintenance

Resources

Tools

Latest Blog Posts

MCP directory API

ComfyUI bridge (when `COMFYUI_URL` is configured)