Shopify MCP Pro

The working Shopify MCP server. Connect Claude to your Shopify store — products, orders, customers, inventory, analytics and more.

Most Shopify MCP packages have broken analytics (stubs that return wrong data), use deprecated API fields that crash at runtime, and require a static token that expires silently. This one doesn't.

Built by Denis Maleev.

Why this one

| What's fixed | Detail | |---|---| | Analytics tools were stubs | getSalesReport, getConversionReport, getTrafficReport now powered by ShopifyQL — real data | | Auth that actually works | Uses Client ID + Secret from Shopify Dev Dashboard, tokens refresh automatically — no silent expiry | | Deprecated API fields | getInventoryLevels, listAbandonedCheckouts updated to Shopify 2026-04 field schema | | Runtime crashes | getShippingZones no longer crashes on stores with no delivery profiles | | New: runShopifyQL | Run any ShopifyQL query directly — same data as Admin → Analytics | | Shopify Admin API | 2026-04 (current GA) + @shopify/shopify-api v13 |

Quick Start

npx @den.dance/shopify-mcp-pro

Setup

1. Create a Custom App in Shopify

Go to your Shopify Admin → Settings → Apps and sales channels
Click Develop apps (enable custom app development if prompted)
Click Create an app, give it a name (e.g. "Claude MCP")
Go to Configure Admin API scopes and select scopes you need (see list below)
Click Install app
Go to API credentials tab — you'll see Client ID and Client secret

Note: Shopify no longer shows a static access token by default. This server uses OAuth with Client ID + Secret.

2. Configure Claude Desktop

Edit your Claude Desktop config file:

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": ["@den.dance/shopify-mcp-pro"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_CLIENT_ID": "your-client-id",
        "SHOPIFY_CLIENT_SECRET": "your-client-secret",
        "SHOPIFY_API_VERSION": "2026-04",
        "SHOPIFY_LOG_LEVEL": "WARNING"
      }
    }
  }
}

Restart Claude Desktop after saving.

Configure Claude Code

claude mcp add shopify -e SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
  -e SHOPIFY_CLIENT_ID=your-client-id \
  -e SHOPIFY_CLIENT_SECRET=your-client-secret \
  -- npx @den.dance/shopify-mcp-pro

Environment Variables

| Variable | Required | Description | |---|---|---| | SHOPIFY_STORE_DOMAIN | Yes | e.g. my-store.myshopify.com | | SHOPIFY_CLIENT_ID | Yes | From Shopify Dev Dashboard | | SHOPIFY_CLIENT_SECRET | Yes | From Shopify Dev Dashboard | | SHOPIFY_API_VERSION | No | Defaults to 2026-04 | | SHOPIFY_LOG_LEVEL | No | error, warning, info, debug (default: warning) | | TRANSPORT_MODE | No | stdio (default) or sse | | PORT | No | HTTP port for SSE mode (default: 3000) |

API Scopes

Minimum recommended

read_products, write_products
read_orders
read_customers
read_inventory, write_inventory

For analytics

read_analytics
read_reports

Full feature set

read_draft_orders, write_draft_orders
read_fulfillments, write_fulfillments
read_shipping
read_marketing_events, write_marketing_events
read_discounts, write_discounts
read_price_rules, write_price_rules
read_themes
read_content, write_content
read_metaobjects, write_metaobjects
read_gift_cards, write_gift_cards

You don't need all scopes — the server works with whatever you grant. Tools requiring missing scopes return auth errors without affecting others.

Tools

Products & Inventory

listProducts — list with filters, pagination, sort
getProduct — get by ID (includes inventory item IDs)
createProduct, updateProduct
getInventoryLevels — current stock across locations
adjustInventory — adjust quantities
listCollections
setMetafield
listMetaobjectDefinitions, createMetaobject, listMetaobjects

Orders & Fulfillment

listOrders, getOrder
createDraftOrder, listDraftOrders
createFulfillment, listFulfillmentOrders
getShippingZones
createRefund
listTransactions

Customers & B2B

listCustomers, getCustomer
getCustomerAnalytics
createCompany, listCompanies

Financial

getFinancialSummary
createGiftCard, listGiftCards

Marketing & Content

createDiscountCode, listDiscounts
listPriceRules
createPage, listPages
createArticle, listBlogs
createRedirect
createWebhook, listWebhooks

Analytics & Reporting

getSalesReport — revenue, orders, AOV (ShopifyQL)
getProductAnalytics — top products by sales (ShopifyQL)
getConversionReport — product conversion funnel (ShopifyQL)
getTrafficReport — sales by referrer source (ShopifyQL)
getAbandonmentReport — cart abandonment by date range
listAbandonedCheckouts
getMarketingReport
getCustomerAnalytics
runShopifyQL — run any ShopifyQL query directly

Store Config

getShopInfo
listThemes
listLocations
listMarkets
getInventoryReport
getCustomReport

ShopifyQL

runShopifyQL lets you run raw ShopifyQL queries — Shopify's native SQL-like analytics language:

FROM sales SHOW total_sales, gross_sales, total_orders SINCE '2026-01-01' UNTIL '2026-05-19'
FROM products SHOW total_sales BY product_title ORDER BY total_sales DESC LIMIT 10
FROM sessions SHOW sessions BY referrer_source

Requires read_reports scope + Level 2 customer data access in your Shopify app settings.

Example prompts for Claude

"Show sales for last month broken down by product"
"Which products have less than 10 units in stock?"
"Create a 20% discount code valid until end of month"
"List abandoned checkouts from the past week"
"Run a ShopifyQL query: FROM sales SHOW total_orders SINCE -30d"
"Get customer lifetime value metrics"
"Show top 10 products by revenue this year"

SSE Mode

For HTTP-based access or cloud deployment:

TRANSPORT_MODE=sse \
SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
SHOPIFY_CLIENT_ID=your-client-id \
SHOPIFY_CLIENT_SECRET=your-client-secret \
PORT=3000 \
npx @den.dance/shopify-mcp-pro

Endpoints:

GET /sse — SSE stream
POST /messages?sessionId={id} — send messages
GET /health — health check

Configure Claude Desktop for remote SSE:

{
  "mcpServers": {
    "shopify-remote": {
      "transport": {
        "type": "sse",
        "url": "https://your-server.com/sse"
      }
    }
  }
}

Security

Never commit credentials to version control
Use environment variables for all secrets
Create separate apps with minimal scopes for different use cases
Regularly rotate your Client Secret

License

MIT

MCP Servers