Shopify Server

Tests License Node Docker

A Model Context Protocol (MCP) server that provides full access to the Shopify Admin GraphQL API. Covers the complete merchant experience with 75 tools spanning products, orders, customers, inventory, collections, discounts, analytics, fulfillment, and more.

Features

• Full Shopify Admin API coverage — 75 MCP tools matching the Shopify mobile app's capabilities
• Dual authentication — Static access token for quick setup, OAuth client credentials for production
• GraphQL Admin API — Uses Shopify's modern GraphQL API (2026-01 version)
• Cost-aware rate limiting — Tracks Shopify's throttle bucket and backs off automatically
• ShopifyQL analytics — Sales, orders, inventory, financial, and top products reports
• TypeScript — Full type safety with strict mode

Category	Tools
Products	list-products, get-product, create-product, update-product, delete-product, search-products, list-product-variants, create-product-variant, update-product-variant, delete-product-variant, manage-product-options, manage-product-images
Orders	list-orders, get-order, cancel-order, close-order, reopen-order, update-tracking, create-refund, calculate-refund, list-order-risks, add-order-note, list-order-transactions
Customers	list-customers, get-customer, create-customer, update-customer, delete-customer, search-customers, merge-customers, manage-customer-addresses
Discounts	list-discount-codes, create-discount-code, update-discount-code, delete-discount-code, create-automatic-discount, delete-automatic-discount
Inventory	list-inventory-levels, adjust-inventory, set-inventory, list-inventory-items, move-inventory
Collections	list-collections, get-collection, create-collection, update-collection, manage-collection-products
Draft Orders	list-draft-orders, get-draft-order, create-draft-order, update-draft-order, complete-draft-order
Analytics	get-sales-report, get-orders-report, get-inventory-report, get-financial-summary, get-top-products
Shop	get-shop-info, list-shop-policies, list-payment-settings, list-currencies
Metafields	list-metafields, get-metafield, set-metafield, delete-metafield
Fulfillment	list-fulfillment-orders, create-fulfillment, cancel-fulfillment, list-fulfillment-services
Locations	list-locations, get-location, list-location-inventory
Marketing	list-marketing-events, create-marketing-event, get-marketing-activity

Installation

From source

git clone https://github.com/aserper/shopify-mcp.git
cd shopify-mcp
npm install
npm run build

Docker

docker pull ghcr.io/aserper/shopify-mcp:latest

Configuration

Create a Custom App in Shopify Admin → Settings → Apps and sales channels → Develop apps, or register an app in the Shopify Partners Dashboard.

Variable	Required	Description
SHOPIFY_STORE_DOMAIN	Yes	Your store domain (e.g. my-store.myshopify.com)
SHOPIFY_ACCESS_TOKEN	Option 1	Admin API access token from a Custom App
SHOPIFY_CLIENT_ID	Option 2	OAuth client ID from Partners Dashboard
SHOPIFY_CLIENT_SECRET	Option 2	OAuth client secret from Partners Dashboard
SHOPIFY_API_VERSION	No (default: 2026-01)	Shopify API version

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

Usage

Claude Desktop Configuration

{
  "mcpServers": {
    "shopify": {
      "command": "node",
      "args": ["/path/to/shopify-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "my-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
      }
    }
  }
}

Claude Code

claude mcp add shopify-mcp \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxxxx \
  -e SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  -- node /path/to/shopify-mcp/dist/index.js

Docker

docker run --rm \
  -e SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxxxx \
  ghcr.io/aserper/shopify-mcp:latest

Authentication

Static Token — Generate an Admin API access token from a Custom App in your Shopify admin. Simplest setup, token doesn't expire unless revoked.

OAuth Client Credentials — Create an app in the Shopify Partners Dashboard. The server exchanges your client ID and secret for an access token automatically at startup.

Development

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm test             # Run tests
npm run dev          # Watch mode
npm run lint         # Type check

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Shopify Inc. It is an independent, open-source tool that interacts with Shopify's publicly available APIs. "Shopify" is a registered trademark of Shopify Inc.

License

MIT