Back to Browse
ComfyUI bridge (when
Free
Server data from the Official MCP Registry
MCP server for Shopify Admin API with a ComfyUI bridge for AI product image generation.
About
MCP server for Shopify Admin API with a ComfyUI bridge for AI product image generation.
Security Report
7.0
Moderate7.0Low RiskValid MCP server (1 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
5 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
What You'll Need
Set these up before or after installing:
Store domain, e.g. 'my-store' or 'my-store.myshopify.com'
Environment variable: SHOPIFY_STORE
Admin API access token (shpat_...). See README for how to create a custom app on a dev store.Required
Environment variable: SHOPIFY_ACCESS_TOKEN
Shopify GraphQL Admin API version (default: 2026-04)
Environment variable: SHOPIFY_API_VERSION
ComfyUI HTTP URL for bridge tools. When unset, generate_* bridge tools are disabled.
Environment variable: COMFYUI_URL
Externally-reachable ComfyUI URL (defaults to COMFYUI_URL)
Environment variable: COMFYUI_PUBLIC_URL
Default ComfyUI checkpoint filename for bridge tools (default: sd_xl_base_1.0.safetensors)
Environment variable: COMFYUI_DEFAULT_CKPT
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-miller-joe-shopify-mcp": {
"env": {
"COMFYUI_URL": "your-comfyui-url-here",
"SHOPIFY_STORE": "your-shopify-store-here",
"COMFYUI_PUBLIC_URL": "your-comfyui-public-url-here",
"SHOPIFY_API_VERSION": "your-shopify-api-version-here",
"COMFYUI_DEFAULT_CKPT": "your-comfyui-default-ckpt-here",
"SHOPIFY_ACCESS_TOKEN": "your-shopify-access-token-here"
},
"args": [
"-y",
"@miller-joe/shopify-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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 | 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 TIMESERIESFROM 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_querywith 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:
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
3
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
404
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
89.9K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local