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

| Tool | Description | |------|-------------| | get_products | List products with filtering/pagination | | get_product | Get single product by ID | | get_product_variants | List product variants | | get_product_tags | Get all product tags | | get_product_types | Get all product types | | get_product_vendors | Get all product vendors | | get_products_count | Count products |

Order Tools

| Tool | Description | |------|-------------| | get_orders | List orders with filtering/pagination | | get_order | Get single order by ID | | get_orders_count | Count orders | | get_abandoned_checkouts | List abandoned checkouts | | get_abandoned_checkouts_count | Count abandoned checkouts |

Customer & Segment Tools

| Tool | Description | |------|-------------| | get_customers | List customers with filtering | | get_customer | Get single customer by ID | | get_customers_count | Count customers | | get_segments | List customer segments | | get_segment | Get single segment by ID | | get_segment_members | Get customers in a segment |

Marketing Tools

| Tool | Description | |------|-------------| | get_marketing_activities | List marketing activities | | get_marketing_activity | Get single marketing activity | | get_marketing_events | List marketing events | | get_marketing_event | Get single marketing event |

Discount Tools

| Tool | Description | |------|-------------| | get_discounts | List all discounts | | get_discount | Get single discount by ID | | get_code_discounts | List code-based discounts | | get_automatic_discounts | List automatic discounts |

Collection Tools

| Tool | Description | |------|-------------| | get_collections | List collections | | get_collection | Get single collection by ID | | get_collections_count | Count collections |

Inventory & Location Tools

| Tool | Description | |------|-------------| | get_inventory_items | List inventory items | | get_inventory_item | Get single inventory item | | get_locations | List locations | | get_location | Get single location |

Shop Tools

| Tool | Description | |------|-------------| | get_shop | Get shop information | | get_shop_locales | Get shop locales | | run_shopifyql | Run custom ShopifyQL query |

Analytics Tools

| Tool | Description | |------|-------------| | get_sales_over_time | Sales trends by day/week/month | | get_sales_by_product | Top selling products | | get_sales_by_region | Sales breakdown by country | | get_sales_by_traffic_source | Sales by referrer/source | | get_sessions_over_time | Traffic/session trends | | get_conversion_rate | Session to order conversion rate | | get_average_order_value | AOV trends over time | | get_top_customers | Highest spending customers | | get_conversions_by_channel | Conversion rates by channel | | get_campaign_performance | Campaign performance metrics | | get_campaign_performance_over_time | Campaign trends over time |

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