Shopify MCP Server

An MCP server that gives AI assistants real-time access to your Shopify store analytics through ShopifyQL and the Admin GraphQL API.

What It Does

Connect any MCP-compatible AI assistant (Claude, GPT, Cursor, etc.) to your Shopify store. Ask questions in plain English — the server translates them into ShopifyQL queries and GraphQL calls, then returns real data from your store. Sales, orders, inventory, traffic, marketing — all queryable through conversation.

Tools

Setup

Prerequisites

• Node.js 18+

• A Shopify store with a custom app

1. Create a Shopify Custom App

1. In your Shopify admin, go to Settings > Apps and sales channels > Develop apps

2. Click Create an app and give it a name

3. Under Configuration, click Configure Admin API scopes and enable these scopes:

4. Click Save and then Install app

2. Get Your Access Token

The included get-token.js script handles the OAuth flow:

node get-token.js <shop.myshopify.com> <client_id> <client_secret>

This starts a local server, opens your browser to authorize the app, and prints the access token to your terminal. Copy it — you'll need it next.

3. Build the Server

npm install
npm run build

4. Configure Your MCP Client

Add the server to your .mcp.json (or equivalent config for your AI tool):

{
  "mcpServers": {
    "shopify": {
      "command": "node",
      "args": ["/path/to/shopify-mcp-server/dist/index.js"],
      "env": {
        "SHOPIFY_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx",
        "SHOPIFY_API_VERSION": "2025-10"
      }
    }
  }
}

Replace /path/to/shopify-mcp-server with the actual path to this project on your machine.

Environment Variables

Usage Examples

Once configured, ask your AI assistant things like:

• "How are sales this month compared to last month?" — triggers shopify_sales_summary with comparison

• "What are my top 10 products by revenue this quarter?" — triggers shopify_sales_by_product

• "What's my conversion rate this week, broken down by traffic source?" — triggers shopify_traffic grouped by referrer

• "Show me any products with fewer than 5 units in stock" — triggers shopify_inventory with low-stock filter

• "How much am I spending on Shop campaigns and what's the return?" — triggers shopify_shop_campaign_insights

The AI picks the right tool automatically based on your question.

License

MIT

Built By

Hamza Shahbaz — Senior web developer, 13+ years building for the web.

• hamzashahbaz.com

• GitHub

• LinkedIn