Shopify MCP Server: Setup Guide, Use Cases & Limitations

What Is Shopify MCP Server?

Shopify MCP Server is an MCP server maintained by Shopify that lets Claude query products, orders, customers, and analytics data from a Shopify store. It is developed and published officially by Shopify under the @shopify/dev-mcp npm package.

Quick Facts

What You Can Do With It

• Product management: Query product listings, variants, pricing, and metadata directly from your store catalog.
• Order tracking: Retrieve order status, fulfillment details, and order history without leaving your Claude session.
• Customer data: Look up customer records, contact information, and purchase history.
• Inventory queries: Check stock levels and inventory state across products and locations.

How to Set It Up

Claude Code (CLI)

Run the server directly with npx — no global install required:

npx @shopify/dev-mcp
To register it as a persistent MCP server in Claude Code, add the following to your `.claude/mcp.json`:

```json
{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["@shopify/dev-mcp"]
    }
  }
}

Claude Desktop

Add the following block to your claude_desktop_config.json (typically located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["@shopify/dev-mcp"]
    }
  }
}

Restart Claude Desktop after saving the config. Confirm the server appears as a connected tool in the Claude interface before issuing any store queries.

Authentication

You will need to supply Shopify store credentials or API access tokens for the server to connect to your store. Check the GitHub repository for the current authentication setup — environment variables or a config file are the typical mechanisms for servers of this type.

Works Best With

Shopify MCP Server is documented as compatible with both Claude Code and Claude Desktop. Claude Code is the better fit for developers running automated queries, scripting store data workflows, or integrating with other CLI tools. Claude Desktop suits interactive, conversational use — for example, asking ad-hoc questions about orders or customer records during day-to-day store operations.

Known Limitations

• Authentication required: The server needs valid Shopify API credentials. Without proper store access tokens or API keys configured, all queries will fail. Review the repository README for the exact environment variable names and scopes needed.
• Shopify API rate limits apply: Shopify’s REST and GraphQL APIs enforce rate limits (typically 2 requests/second for REST, leaky-bucket for GraphQL). Heavy query workloads may encounter throttling that surfaces as errors in Claude.
• Read vs. write scope: Confirm which operations the server exposes as tools — MCP servers of this type often support reads (query, lookup) more broadly than writes (create, update, delete). Check the tools list in the GitHub repo before assuming write access.
• Store plan dependencies: Some Shopify data (analytics, for example) may only be available on certain store plans.
• npx cold start: Running via npx means the package is fetched on first use, which adds latency on initial connection.

Community Resources

• GitHub Repository & Issues — File bugs, review open issues, and track development updates here.
• Shopify Developer Forums — The official Shopify developer community for API and tooling questions.
• r/ClaudeAI on Reddit — Community discussions about Claude integrations, including MCP server setups.