home / mcp / shopify mcp server

Shopify MCP Server

Provides a Shopify API MCP server enabling GraphQL-based access to products, customers, orders, and more.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "therealhexi-shopify-mcp-server-main": {
      "command": "npx",
      "args": [
        "-y",
        "shopify-mcp-server"
      ],
      "env": {
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
      }
    }
  }
}

You can use the Shopify MCP Server to interact with your Shopify store data through a GraphQL-based MCP interface. It enables you to query products, customers, orders, and more with a clear set of tools, while handling authentication and errors gracefully.

How to use

You will connect to the Shopify MCP Server from an MCP client or integration that supports the Model Context Protocol. Once connected, you can perform common store operations such as listing products, retrieving customers, querying orders with filters, and managing discounts or draft orders. Each tool focuses on a specific data operation, returning structured results you can use in your workflows or integrations.

How to install

Prerequisites you need before running the server: install Node.js and npm on your machine.

Install and configure the Shopify MCP Server in your client environment. The following example shows how to configure Claude Desktop to run the MCP server using npx and to supply the required Shopify credentials.

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-mcp-server"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com"
      }
    }
  }
}

Configuration and security

Keep your Shopify Admin API access token secure. Do not expose tokens in code or version control. Use environment variables or secret management to provide the token to your MCP client or runtime.

Environment variables you will typically provide include SHOPIFY_ACCESS_TOKEN and MYSHOPIFY_DOMAIN. These values enable authentication against your Shopify store and define the store domain the server will connect to.

Troubleshooting and notes

If you encounter authentication errors, double-check that the access token has the necessary scopes (read and write permissions for products, customers, and orders) and that the domain matches your Shopify store. Ensure that the token has not expired and that it is being supplied to the MCP client at runtime.

Available tools

get-products

Retrieve all products or search by title with optional filters

get-products-by-collection

Fetch products belonging to a specific collection with optional limit

get-products-by-ids

Retrieve product details for a list of product IDs

update-product-price

Update the price for a specific product by its ID

get-variants-by-ids

Get detailed information for product variants by IDs

get-customers

Load customers with pagination support

tag-customer

Add tags to a customer by their ID

get-orders

Query orders with advanced filtering and sorting options

get-order

Retrieve a single order by its ID

create-discount

Create a basic discount code with configurable terms

create-draft-order

Create a draft order with line items and customer details

complete-draft-order

Complete a draft order by finalizing the draft and selecting a variant

get-collections

List all collections with optional filters

get-shop

Fetch basic shop details

get-shop-details

Fetch extended shop details including shipping countries

manage-webhook

Subscribe, find, or unsubscribe webhooks