Shopify MCP Server: Let Claude Manage Your Store

Running a Shopify store means constantly context-switching — opening the admin to check an order, filtering customers by purchase history, hunting for which products are running low on stock. Every one of those tasks pulls you out of whatever you were doing. The Shopify MCP server puts your entire store data inside Claude's reach. Ask it a question in plain English and get the answer instantly, whether you are in the middle of writing a customer email, planning a restock, or analyzing last week's sales.

What is Shopify?

Shopify is the world's leading e-commerce platform, powering over two million merchants across more than 175 countries. It provides everything needed to run an online store: product catalog management, payment processing, inventory tracking, customer management, order fulfillment, and marketing tools — all in one platform. Shopify's Admin API gives developers programmatic access to all of this data, enabling apps and integrations to query and manage store operations without using the web interface.

What the Shopify MCP Server Does

The Shopify MCP server wraps the Shopify Admin API and exposes it as tools Claude can call during your conversations. Once connected, Claude has access to:

• List recent orders — filter by date, status, amount, customer, or fulfillment state.
• Get order by ID — retrieve full order details including line items, shipping address, payment status, and timeline.
• Search customers — find customers by email, name, or tags; see purchase history and total spend.
• List products — retrieve your product catalog with titles, variants, prices, and SKUs.
• Check inventory levels — see current stock quantities across all locations for any product or variant.
• Get fulfillment status — check which orders have shipped, which are pending, and tracking information where available.
• List draft orders — view outstanding draft orders that haven't been converted to active orders yet.

This turns your entire store into a conversational database. For an overview of how MCP servers expose API tools to Claude, see our what is an MCP server explainer.

Prerequisites

Before setting up the Shopify MCP server, gather the following:

• Shopify store — any plan including Basic. Development stores also work for testing.
• Shopify Custom App with Admin API access — go to Settings → Apps → Develop apps → Create an app. This generates the access token the MCP server uses. See the FAQ below for step-by-step instructions.
• Admin API access token — generated when you install your Custom App. Starts with shpat_. Copy it immediately as Shopify shows it only once.
• Your shop domain — in the format your-store.myshopify.com. Find this under Settings → Domains.
• Node.js 18 or higher — check with node --version.

How to Install the Shopify MCP Server

1. Create a Shopify Custom App. In your Shopify admin, navigate to Settings → Apps and sales channels → Develop apps → Create an app. Name it (e.g., "Claude MCP"). Under "Configure Admin API scopes," select the permissions you need: at minimum, read_orders, read_customers, read_products, and read_inventory. Save and install the app to generate your access token.
2. Copy your Admin API access token. After installation, Shopify displays the token once under the API credentials tab. Copy and store it securely — it starts with shpat_.
3. Open claude_desktop_config.json. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Windows: %APPDATA%\Claude\claude_desktop_config.json. Our config file guide has the complete walkthrough.
4. Add the Shopify server block using the configuration below, substituting your token and shop domain.
5. Save the file and restart Claude Desktop. The server connects to your store on next launch.

The Config JSON

Add this to the mcpServers object in your claude_desktop_config.json. Note that this server requires two environment variables — your access token and your shop domain:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-shopify"],
      "env": {
        "SHOPIFY_ACCESS_TOKEN": "shpat_your_token_here",
        "SHOPIFY_SHOP_DOMAIN": "your-store.myshopify.com"
      }
    }
  }
}

Keep your access token secure — treat it like a password. Review our MCP security guide for how to handle API tokens safely in your config file. If you also want to track payment status from Stripe, pair this with the Stripe MCP server for full commerce coverage.

Real Use Cases

Here are five store management tasks Claude handles naturally once the server is connected:

1. "Show me all orders over $200 placed in the last 48 hours." Claude queries orders with a minimum value filter and a 48-hour timestamp range, returning a formatted list with order numbers, customer names, amounts, and fulfillment status.
2. "Look up customer sarah@example.com and tell me her order history." Claude finds the customer by email and returns her total order count, lifetime spend, most recent order details, and any tags on her account.
3. "Which products are low on inventory (under 10 units)?" Claude queries inventory levels across all products and variants, returning a prioritized list of items that need restocking before they run out.
4. "How many orders are still unfulfilled from last week?" Claude filters orders by creation date and fulfillment status, giving you a count and a list of order IDs so you can action them.
5. "What's our best-selling product this month?" Claude aggregates order line items from the current month and ranks products by units sold and revenue generated.

Pros

• Major time saver for store operations — common support and operations queries that required multiple Shopify admin page loads now take a single sentence.
• Natural language replaces complex filter interfaces — instead of navigating date range pickers and status dropdowns, you just describe what you want in plain English.
• Works on any Shopify plan — no Shopify Plus or enterprise plan required; the Custom App approach is available to all merchants.
• Pairs perfectly with the Stripe MCP server — combine Shopify order data with Stripe payment data to get a complete picture of a transaction from product to charge.

Cons / Limitations

• Custom App setup takes about 20 minutes — it is not a plug-and-play installation like some other MCP servers. You need to navigate Shopify's app creation flow and configure the right API scopes.
• Write operations have limited support — creating or editing orders, products, and customer records is not fully supported in the current server version. Check the package README for the latest write capabilities.
• Large stores may hit API rate limits on bulk queries — Shopify's Admin API has rate limits. Queries that touch thousands of orders or products may be throttled, requiring Claude to paginate through results over multiple API calls.