Shopify MCP Server

A comprehensive Model Context Protocol (MCP) server for the Shopify Admin API. Connect Claude (or any MCP client) to your Shopify store to manage products, orders, customers, inventory, metaobjects, discounts, and more.

Features

• Products — list, create, update, delete, publish/unpublish, variants CRUD, images (URL and base64), metafields, category taxonomy
• Collections — custom & smart collections, add products, list collection products
• Orders — list, get, create, update, cancel, close, fulfill, refund, transactions
• Draft Orders — list, create, complete
• Customers — list, search, get, create, update, delete, customer order history
• Inventory — locations, get/adjust/set inventory levels
• Metaobjects — definitions (list/create) and entries (list/create/update/delete) via GraphQL
• Metafields — get/set on products and variants
• Discounts — price rules and discount codes (list, create, delete)
• Publishing — list sales channels, publish/unpublish products to channels
• Themes — list, create, update, delete themes; list, read, write, delete theme files (assets)

Installation

npx (recommended)

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "github:slackermafia/Shopify-MCP-Server"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxx"
      }
    }
  }
}

Clone & run locally

git clone https://github.com/slackermafia/Shopify-MCP-Server.git
cd Shopify-MCP-Server
npm install
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxx \
node src/index.js

Configuration

Environment Variable	Description
SHOPIFY_STORE_DOMAIN	Your store domain, e.g. store.myshopify.com
SHOPIFY_ACCESS_TOKEN	Shopify Admin API access token

Getting an Access Token

1. Go to your Shopify Admin → Settings → Apps and sales channels → Develop apps
2. Create a private app and grant it the Admin API scopes you need
3. Copy the Admin API access token

Recommended scopes: read_products, write_products, read_orders, write_orders, read_customers, write_customers, read_inventory, write_inventory, read_price_rules, write_price_rules, read_discounts, write_discounts, read_content, write_content, read_metaobjects, write_metaobjects, read_themes, write_themes

Available Tools (71)

Shop

Tool	Description
get_shop_info	Get store name, domain, currency, plan info

Products

Tool	Description
list_products	List products with filters (status, vendor, type, collection)
get_product	Get a product by ID with all variants and images
create_product	Create a product with variants, options, images, and metafields
update_product	Update title, description, vendor, status, tags
delete_product	Permanently delete a product
publish_product	Publish or unpublish a product
set_product_category	Set product category using Shopify standard taxonomy (GraphQL)
list_product_taxonomy	List all product categories in the Shopify taxonomy
list_product_variants	List all variants for a product
create_product_variant	Add a new variant (price, SKU, options, inventory)
update_product_variant	Update a variant's price, SKU, weight, options
delete_product_variant	Remove a variant from a product
get_product_metafields	Get metafields on a product
set_product_metafield	Create or update a metafield on a product
add_product_image	Add an image to a product by URL
add_product_image_base64	Upload a base64-encoded image and attach it to a product (uses staged uploads)

Variant Metafields

Tool	Description
set_variant_metafield	Set or update a metafield on a specific product variant

Publishing / Sales Channels

Tool	Description
list_publications	List all sales channels / publications the store has enabled
publish_product_to_channel	Publish a product to one or more sales channels
unpublish_product_from_channel	Remove a product from a specific sales channel

Collections

Tool	Description
list_collections	List all custom and smart collections
get_collection	Get a collection by ID
create_collection	Create a new custom collection
update_collection	Update collection title, description, sort order
add_product_to_collection	Add a product to a custom collection
list_collection_products	List products in a collection

Orders

Tool	Description
list_orders	List orders with status/financial/fulfillment filters
get_order	Get full order details
create_order	Create an order programmatically
update_order	Update order note, tags, email, shipping address
cancel_order	Cancel with reason, optional restock and refund
close_order	Mark order as closed
fulfill_order	Create a fulfillment with tracking info
create_refund	Refund line items or shipping
get_order_transactions	Get all payment transactions

Draft Orders

Tool	Description
list_draft_orders	List draft orders
create_draft_order	Create a draft order with custom discounts
complete_draft_order	Convert draft to a live order

Customers

Tool	Description
list_customers	List all customers
search_customers	Search by name, email, or phone
get_customer	Get customer by ID
create_customer	Create a new customer with addresses
update_customer	Update customer details
delete_customer	Delete a customer
get_customer_orders	Get order history for a customer

Inventory

Tool	Description
list_locations	List all fulfillment locations
get_inventory_levels	Get inventory by location or item
adjust_inventory	Relative adjustment (+/-) to inventory
set_inventory_level	Set absolute inventory quantity

Discounts

Tool	Description
list_price_rules	List all price rules
create_price_rule	Create a price rule (fixed amount or percentage)
create_discount_code	Create a discount code for a price rule
list_discount_codes	List codes for a price rule
delete_discount_code	Delete a discount code

Metaobjects (GraphQL)

Tool	Description
list_metaobject_definitions	List all metaobject definitions (content types)
create_metaobject_definition	Create a new metaobject definition with fields
list_metaobjects	List metaobject entries by type
create_metaobject	Create a new metaobject entry
update_metaobject	Update metaobject fields
delete_metaobject	Delete a metaobject entry

Themes

Tool	Description
list_themes	List all themes in the store
get_theme	Get a theme by ID
create_theme	Create a new theme (from a ZIP URL or blank)
update_theme	Update a theme (name or role/publish)
delete_theme	Delete a theme

Theme Assets (Files)

Tool	Description
list_theme_assets	List all file paths in a theme
get_theme_asset	Read a theme file by key (e.g. templates/index.json)
put_theme_asset	Create or update a theme file (text content or URL source)
delete_theme_asset	Delete a theme file

Requirements

• Node.js 18+
• Shopify store with Admin API access

A note on Shopify's REST API

Shopify marked the REST Admin API as legacy as of October 1, 2024, with new public apps required to use GraphQL exclusively from April 2025 onward. This server uses the latest stable REST API version (2026-01) for broad compatibility with private/custom apps and is fully functional. The metaobjects, product taxonomy, publishing, and image upload features already use GraphQL. Future versions of this server may migrate remaining endpoints to GraphQL.

License

MIT