---

name: shopify category: integration-connectivity/mcp-integrations version: 1.0.0 description: Complete guide to using Shopify Dev MCP server with Claude Code author: blackbox5/mcp verified: true tags: [mcp, shopify, ecommerce, api]

Shopify Dev MCP Server Skills

Configuration: HTTP proxy at http://localhost:3000/mcp/shopify

Prerequisites:

1. A working Shopify store
2. Shopify API credentials (API key and password)
3. Store URL (e.g., https://your-store.myshopify.com)

Configure your Shopify API credentials in the MCP proxy server environment variables.

Always start with exploration (get store info, list products) before making changes. Use filters to limit results and avoid overwhelming data.

<available_skills> <skill_group name="Store Management"> Get basic information about your Shopify store Get my store information Store name, domain, email, currency, timezone List products from your store Get all products created in the last 7 days Number of products to return (default: 50) Retrieve products after this ID Filter by creation date Get details of a specific product Get product with ID 123456789 Product ID or handle Create a new product Create a new product with title 'New T-Shirt' and price $29.99 Product title Product description (HTML) Vendor name Product type Array of product variants Update an existing product Update product 123456789 to set price to $39.99 Product ID Object containing fields to update Delete a product (cannot be undone) Delete product 123456789 This action cannot be undone </skill_group>

<skill_group name="Order Management"> Get orders from your store Get unpaid orders from the last week Order status (open, closed, cancelled, etc.) Filter by date Number of orders (default: 50) Get details of a specific order Get order with ID 987654321 Customer information, line items, shipping address, payment status, fulfillment status Create a new order manually Create a new order for customer@example.com Customer email Array of product variants Shipping details Payment status Update an existing order Update order 987654321 to mark as paid Order ID Fields to update Cancel an order Cancel order 987654321 with reason 'customer' Cancellation reason (customer, inventory, fraud, etc.) </skill_group>

<skill_group name="Customer Management"> Get customers from your store Get customers who purchased in the last month Get details of a specific customer Get customer with ID 555555555 Create a new customer Create a new customer with email john@example.com Customer email (required) First name Last name Phone number Update a customer Update customer 555555555 to set phone to 555-1234 </skill_group>

<skill_group name="Inventory Management"> Get inventory levels Check inventory for product 123456789 Update inventory levels Set inventory for SKU TSHIRT-001 to 50 Inventory item ID New quantity Location ID </skill_group>

<skill_group name="Collection Management"> Get product collections Get smart collections Create a new collection Create a collection called 'Summer Sale' Collection title Array of product IDs Smart collection rules (for smart collections) </skill_group> </available_skills>

<best_practices> Use product handles for easier identification Keep inventory updated regularly Use collections to organize products Test operations in development first Monitor API rate limits Start with exploration using get_store_info Use filters to limit results Check errors and understand API responses Delete products without backup Create duplicate products Ignore API errors Exceed rate limits Hardcode IDs in workflows </best_practices>

<error_handling> Connection error Verify MCP proxy is running: curl http://localhost:3000/health Check Shopify API credentials Ensure store URL is correct Authentication failed Verify API key and password Check API permissions in Shopify admin Ensure credentials have required scopes Rate limit exceeded Slow down requests Use pagination for large datasets Cache frequently accessed data Product not found Verify product ID or handle Check if product is deleted Ensure you're querying the right store </error_handling>

<integration_notes> Lumelle Partnership Platform Get all partner products from Shopify Create a new partner product Update partner pricing Get orders for partner products Fulfill partner orders Track partner shipments Check inventory levels Update Shopify inventory from Lumelle Sync product data between systems </integration_notes>

<rate_limits> 40 requests per minute 80 requests per minute 1000 requests per minute Claude will automatically handle rate limiting and retry requests </rate_limits>