███████╗██╗  ██╗ ██████╗ ██████╗ ██╗███████╗██╗   ██╗    ███╗   ███╗ ██████╗██████╗ 
██╔════╝██║  ██║██╔═══██╗██╔══██╗██║██╔════╝╚██╗ ██╔╝    ████╗ ████║██╔════╝██╔══██╗
███████╗███████║██║   ██║██████╔╝██║█████╗   ╚████╔╝     ██╔████╔██║██║     ██████╔╝
╚════██║██╔══██║██║   ██║██╔═══╝ ██║██╔══╝    ╚██╔╝      ██║╚██╔╝██║██║     ██╔═══╝ 
███████║██║  ██║╚██████╔╝██║     ██║██║        ██║       ██║ ╚═╝ ██║╚██████╗██║     
╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝        ╚═╝       ╚═╝     ╚═╝ ╚═════╝╚═╝     

Shopify MCP

A Model Context Protocol (MCP) server that connects agents to the Shopify Admin GraphQL API. Use it to browse, edit, and clean up store data via a curated set of tools.

npm: shopify-mcp
binary: shopify-mcp

Highlights

• CRUD for products, collections, orders, and customers
• Draft orders for quotes, manual orders, and B2B pricing
• Inventory and location lookups for stock workflows
• Metafields for custom data
• URL redirects management
• OAuth login flow with local token caching
• Bulk product cleanup utilities

Prerequisites

• Node.js 18+
• A Shopify custom app (OAuth or Admin API token)

Install + run

OAuth flow (recommended)

1. Create a custom app and copy Client ID and Client Secret.
2. In App setup, set App URL and Allowed redirection URLs to: http://localhost:3456/callback
3. Start the OAuth flow:

npx shopify-mcp --oauth --domain=your-store.myshopify.com --clientId=xxx --clientSecret=yyy

Tokens are stored at ~/.shopify-mcp/tokens.json. After that, start the server with just the domain:

npx shopify-mcp --domain=your-store.myshopify.com

Optional: override scopes with --scopes or SHOPIFY_SCOPES.

Access token (manual)

1. Create a custom app in Shopify
2. Enable Admin API scopes:
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
   • read_draft_orders, write_draft_orders
   • read_inventory, write_inventory
   • read_locations
   • read_content, write_content
   • read_files, write_files
3. Install the app and copy the Admin API access token

Run:

shopify-mcp --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

MCP client setup

Claude Desktop

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--accessToken",
        "<YOUR_ACCESS_TOKEN>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

If you completed OAuth, omit --accessToken and keep --domain.

Config paths:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Environment variables (optional)

SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com
# Optional OAuth values:
# SHOPIFY_CLIENT_ID=your_client_id
# SHOPIFY_CLIENT_SECRET=your_client_secret
# SHOPIFY_SCOPES=comma,separated,scopes

Tool catalog

Products

• get-products (supports fields: slim | standard | full | [])
• get-product-by-id
• create-product
• update-product
• delete-product
• delete-variant
• delete-product-images
• search-products (supports fields)
• bulk-update-products
• bulk-delete-products

Collections

• get-collections
• manage-collection-products
• create-collection
• update-collection
• delete-collection

Customers

• get-customers (supports pagination via cursor)
• update-customer
• get-customer-orders (supports pagination via cursor)

Orders

• get-orders (supports pagination via cursor)
• get-order-by-id
• update-order

Draft Orders

• get-draft-orders (supports pagination via cursor)
• get-draft-order-by-id
• create-draft-order
• update-draft-order
• complete-draft-order

Inventory

• get-inventory-levels
• update-inventory

Locations

• get-locations

Metafields

• get-metafields
• set-metafield (create or update)
• delete-metafield

URL redirects

• get-redirects
• create-redirect
• delete-redirect

Analytics

• get-store-counts - Get all key counts in one call (products, variants, orders, customers, collections)
• get-product-issues - Audit products for problems (zero inventory, low stock, missing images, zero price)

Bulk Operations

• start-bulk-export - Start async bulk export (products, orders, customers, inventory, or custom query)
• get-bulk-operation-status - Check progress of bulk operation
• get-bulk-operation-results - Download and parse completed results (summary, sample, or full)

Debugging

Tail Claude Desktop logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

License

MIT