Shopify Admin MCP Server

An MCP (Model Context Protocol) server that provides read-only access to the Shopify Admin GraphQL API.

Features

• Read-only access to Shopify Admin data
• 35 core tools for products, orders, customers, marketing, discounts, collections, inventory, and shop info
• 12 ShopifyQL analytics tools (optional, requires Level 2 access) for sales, conversions, campaigns, and more

Quick Start

1. Create a Shopify Custom App

1. In your Shopify admin, go to Settings → Apps and sales channels → Develop apps
2. Click Allow custom app development (if not already enabled)
3. Click Create an app and name it (e.g., "Claude MCP")
4. Click Configure Admin API scopes and enable:
   • read_products
   • read_orders
   • read_customers
   • read_marketing_events
   • read_discounts
   • read_inventory
   • read_locations
   • read_locales
   • read_analytics
   • read_reports
5. Click Save, then click Install app
6. In the API credentials tab, copy the API key and API secret key

ShopifyQL & Analytics Requirements

The ShopifyQL-powered analytics tools (run_shopifyql, get_sales_over_time, get_top_customers, etc.) require additional access beyond API scopes:

1. read_reports scope - Already included in the scopes above
2. Level 2 Protected Customer Data Access - Required for ALL ShopifyQL queries, even those not accessing customer data

To enable Level 2 access:

1. Go to the Shopify Partner Dashboard
2. Navigate to Apps → Your App → API access
3. Under Protected customer data, request Level 2 access
4. Complete the required security attestations
5. Wait for Shopify approval (may take a few days)

By default, ShopifyQL tools are disabled to prevent errors for users without Level 2 access. Once approved, enable them by adding the environment variable:

{
  "mcpServers": {
    "shopify-admin": {
      "command": "npx",
      "args": ["-y", "shopify-admin-mcp"],
      "env": {
        "SHOPIFY_CREDENTIALS_PATH": "/path/to/credentials.json",
        "SHOPIFY_SHOPIFYQL_ENABLED": "true"
      }
    }
  }
}

Note: Non-ShopifyQL tools (products, orders, customers, etc.) work without Level 2 access.

2. Create Credentials File

Create a JSON file with your Shopify credentials (e.g., ~/.shopify-credentials.json):

{
  "shop": "your-store.myshopify.com",
  "clientId": "your-api-key",
  "clientSecret": "your-api-secret-key"
}

3. Configure Your MCP Client

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "shopify-admin": {
      "command": "npx",
      "args": ["-y", "shopify-admin-mcp"],
      "env": {
        "SHOPIFY_CREDENTIALS_PATH": "/path/to/your/shopify-credentials.json"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "shopify-admin": {
      "command": "npx",
      "args": ["-y", "shopify-admin-mcp"],
      "env": {
        "SHOPIFY_CREDENTIALS_PATH": "/path/to/your/shopify-credentials.json"
      }
    }
  }
}

4. Restart and Test

Restart Claude Code/Desktop, then try asking:

• "Get my shop info"
• "Show me sales for the last 7 days"
• "List my top 10 products"

Available Tools

Product Tools

Order Tools

Customer & Segment Tools

Marketing Tools

Discount Tools

Collection Tools

Inventory & Location Tools

Shop Tools

Analytics Tools

Example Usage

Get sales trends

"Show me daily sales for the last 30 days"

Analyze top products

"What are my top 10 best-selling products this month?"

Check campaign performance

"How are my marketing campaigns performing?"

Run custom analytics

"Run this ShopifyQL query: FROM sales SHOW total_sales, orders GROUP BY product_title SINCE -7d ORDER BY total_sales DESC LIMIT 5"

Development

Local Setup

git clone https://github.com/MAYUNO-International-LLC/shopify-admin-mcp.git
cd shopify-admin-mcp
npm install
npm run build

Local MCP Configuration

For local development, point to the built files:

{
  "mcpServers": {
    "shopify-admin": {
      "command": "node",
      "args": ["/path/to/shopify-admin-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

License

MIT