shopify-mcp

MCP server for the Shopify Admin API — 36 tools for products, orders, customers, inventory, fulfillments, collections, analytics, marketing, content, and webhooks.

Tools

Products (5)

| Tool | Description | |------|-------------| | list_products | List/filter products by title, vendor, type, collection, status | | get_product | Detailed product info with variants, images, metafields | | search_products | Full-text search across titles, vendors, tags, SKUs | | product_count | Count products matching filters | | list_collections | List smart and custom collections |

Orders (5)

| Tool | Description | |------|-------------| | list_orders | List/filter orders by status, dates, fulfillment | | get_order | Detailed order with line items, shipping, fulfillments | | recent_orders | Most recent N orders | | unfulfilled_orders | Orders waiting for fulfillment | | order_count | Count orders matching filters |

Customers (3)

| Tool | Description | |------|-------------| | search_customers | Search by name, email, phone | | get_customer | Customer details with addresses and order history | | top_customers | Ranked by total spend or order count |

Inventory (4)

| Tool | Description | |------|-------------| | check_inventory | Inventory levels across locations for a product | | list_locations | All warehouse/store locations | | low_stock_products | Products below inventory threshold | | adjust_inventory | Adjust inventory at a location |

Collections (3)

| Tool | Description | |------|-------------| | get_collection | Collection details with product count and rules | | collection_products | Products within a specific collection | | create_smart_collection | Create automated collections with rules |

Fulfillments (3)

| Tool | Description | |------|-------------| | list_fulfillments | Fulfillments for an order with tracking | | create_fulfillment | Create fulfillment with tracking info | | fulfillment_status_summary | Order counts by fulfillment status |

Analytics (2)

| Tool | Description | |------|-------------| | store_summary | Today's orders, revenue, fulfillment breakdown | | sales_by_product | Revenue and units by product for a date range |

Marketing (4)

| Tool | Description | |------|-------------| | list_price_rules | List all price rules | | get_price_rule | Price rule details with conditions | | create_discount_code | Create discount code for a price rule | | list_discount_codes | List codes for a price rule |

Content (4)

| Tool | Description | |------|-------------| | list_blogs | List blog entries | | list_pages | List store pages | | get_metafields | Get metafields for any resource | | set_metafield | Create or update a metafield |

Webhooks (3)

| Tool | Description | |------|-------------| | list_webhooks | List registered webhooks | | create_webhook | Register a new webhook | | delete_webhook | Remove a webhook |

Setup

Install

git clone https://github.com/ExpertVagabond/shopify-mcp.git
cd shopify-mcp
npm install && npm run build

Get a Shopify Access Token

1. In Shopify admin: Settings > Apps and sales channels > Develop apps
2. Create app, configure Admin API scopes:
   • read_products, write_products, read_orders, write_orders
   • read_customers, read_inventory, write_inventory, read_locations
   • read_fulfillments, write_fulfillments
3. Install and copy the Admin API access token

Claude Desktop / Claude Code Config

{
  "mcpServers": {
    "shopify": {
      "command": "node",
      "args": ["/path/to/shopify-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Rate Limiting

Built-in Shopify rate limiting:

• Monitors X-Shopify-Shop-Api-Call-Limit header
• Proactive throttling when approaching the limit
• Respects Retry-After on 429 responses
• Exponential backoff on 5xx errors
• Up to 3 retries for transient failures

Architecture

src/
  index.ts              MCP server setup, 36 tool registrations
  api.ts                Shopify REST client (rate limiting, pagination, retries)
  tools/
    products.ts         Product listing, search, count
    orders.ts           Order listing, details, counts
    customers.ts        Customer search, details, ranking
    inventory.ts        Stock levels, locations, adjustments
    collections.ts      Collection management
    fulfillments.ts     Fulfillment creation, tracking
    analytics.ts        Store summary, sales reports
    marketing.ts        Price rules, discount codes
    content.ts          Blogs, pages, metafields
    webhooks.ts         Webhook management

Built with TypeScript strict mode, @modelcontextprotocol/sdk (stdio transport), Shopify Admin REST API 2024-10, cursor-based pagination, zero external HTTP dependencies.

License

MIT

Author

Built by Purple Squirrel Media