Skip to main content
Glama
aserper
by aserper

Shopify MCP Server

Tests License Node Docker

GitHub stars GitHub forks

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

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

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/aserper/shopify-mcp'

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