shopify-analytics-mcp

MCP server for the Shopify Admin GraphQL API. Gives Claude full access to your store — products, orders, customers, inventory, analytics, discounts, metafields, and more.

Installation

npx shopify-analytics-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "shopify-analytics-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_your_access_token_here"
      }
    }
  }
}

Getting Your Shopify Credentials

1. Log in to your Shopify admin panel
2. Go to Settings → Apps and sales channels → Develop apps
3. Click Create an app, give it a name
4. Under Configuration, enable the Admin API scopes you need:
   • read_products, write_products
   • read_orders, write_orders
   • read_customers, write_customers
   • read_inventory, write_inventory
   • read_discounts
   • read_fulfillments
   • read_analytics
5. Click Install app
6. Copy the Admin API access token (shown only once)

Available Tools

| Tool | Description | |------|-------------| | test_connection | Test connectivity and return store info | | get_shop_info | Full shop details: name, plan, currency, timezone | | list_products | List/search products with pagination | | get_product | Single product details with variants and images | | list_orders | List orders with filters and sorting | | get_order | Single order with line items, shipping, payment | | list_customers | List/search customers | | get_customer | Customer details with order history | | list_collections | Product collections (smart + custom) | | get_inventory_levels | Inventory levels across all locations | | list_locations | All store locations | | get_sales_analytics | Revenue, order count, AOV for a date range | | list_discounts | Discount codes and price rules | | list_pages | Store pages | | list_blogs | Blogs and articles | | list_metafields | Metafields for any resource | | list_webhooks | Registered webhook subscriptions | | get_fulfillments | Fulfillment details for an order | | list_refunds | Refunds for an order | | execute_graphql | Run any custom GraphQL query |

Example Usage

Once connected, ask Claude things like:

• "Show me all unfulfilled orders from the last 7 days"
• "Which products are low on inventory?"
• "What was the total revenue this month?"
• "Find customers who spent more than $500"
• "List all active discount codes"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SHOPIFY_STORE_DOMAIN | ✅ | Your store domain e.g. mystore.myshopify.com | | SHOPIFY_ACCESS_TOKEN | ✅ | Admin API access token starting with shpat_ |

License

MIT