Shopify MCP Server

Shopify MCP Server

MCP Server for Shopify API, enabling interaction with store data (products, customers, orders, etc.) via GraphQL.

Features

Provides tools for product, customer, and order management, direct GraphQL integration, and clear error handling.

Prerequisites

1. Node.js (v16+)
2. Shopify Custom App Access Token

Installation

Shopify Setup & Configuration

1. Create Custom App: In Shopify admin > Settings > Apps and sales channels > Develop apps > Create an app.
2. Configure Scopes: Grant read/write permissions for products, customers, and orders.
3. Install App & Get Token: Install the app and copy the Admin API access token.
4. Create .env file in the project root:
   SHOPIFY_ACCESS_TOKEN=your_access_token MYSHOPIFY_DOMAIN=your-store.myshopify.com
5. Configure Claude Desktop (claude_desktop_config.json):
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
   { "mcpServers": { "shopify": { "command": "node", "args": ["path/to/shopify-mcp-server/dist/index.js"], "env": { "SHOPIFY_ACCESS_TOKEN": "your_access_token", "MYSHOPIFY_DOMAIN": "your-store.myshopify.com" } } } }

   Note: Use the correct path to the cloned repo and store your token securely.

Available Tools

Product Management

1. findProducts: Get all products or search by title.
   • searchTitle (optional string): Filter by title.
   • limit (number): Max products.
2. listProductsInCollection: Get products from a collection.
   • collectionId (string): Collection ID.
   • limit (optional number, default: 10): Max products.
3. getProductsByIds: Get products by IDs.
   • productIds (array of strings): Product IDs.
4. getVariantsByIds: Get variants by IDs.
   • variantIds (array of strings): Variant IDs.

Customer Management

5. listCustomers: Get customers with pagination.
   • limit (optional number): Max customers.
   • next (optional string): Next page cursor.
6. addCustomerTags: Add tags to a customer.
   • customerId (string): Customer ID.
   • tags (array of strings): Tags to add.

Order Management

7. findOrders: Get orders with advanced filtering/sorting.
   • first (optional number): Limit orders.
   • after (optional string): Next page cursor.
   • query (optional string): Filter query.
   • sortKey (optional enum): Sort field.
   • reverse (optional boolean): Reverse sort.
8. getOrderById: Get a single order by ID.
   • orderId (string): Order ID.
9. createDraftOrder: Create a draft order.
   • lineItems (array): Items (variantId, quantity).
   • email (string): Customer email.
   • shippingAddress (object): Shipping details.
   • note (optional string): Order note.
10. completeDraftOrder: Complete a draft order.
    • draftOrderId (string): Draft order ID.
    • variantId (string): Variant ID.

Discount Management

11. createDiscountCode: Create a basic discount code.
    • title (string): Discount title.
    • code (string): Discount code.
    • valueType (enum): 'percentage' or 'fixed_amount'.
    • value (number): Discount value.
    • startsAt (string): Start date (ISO).
    • endsAt (optional string): End date (ISO).
    • appliesOncePerCustomer (boolean): Limit one use per customer.

Collection Management

12. listCollections: Get all collections.
    • limit (optional number, default: 10): Max collections.
    • name (optional string): Filter by name.

Shop Information

13. getShopDetails: Get basic shop details (No inputs).
14. getExtendedShopDetails: Get extended shop details (No inputs).

Webhook Management

15. manageWebhooks: Manage webhooks.
    • action (enum): 'subscribe', 'find', 'unsubscribe'.
    • callbackUrl (string): Webhook URL.
    • topic (enum): Webhook topic.
    • webhookId (optional string): Required for unsubscribe.

Debugging Tools

16. debugGetVariantMetafield: Get variant & size_chart_json metafield.
    • variantId (string): Variant GID.

Developer Tools

17. introspect_admin_schema: Introspect Admin API GraphQL schema.
    • query (string): Filter term.
    • filter (optional array): Filter by 'types', 'queries', 'mutations', 'all'.
18. search_dev_docs: Search shopify.dev docs.
    • prompt (string): Search query.

Debugging

Check Claude Desktop MCP logs: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Common issues:

• Authentication: Check token, domain format, API scopes.
• API Errors: Check rate limits, input formats, required fields.

Development

Dependencies

• @modelcontextprotocol/sdk
• graphql-request
• zod

License

MIT

Note: Fork of original shopify-mcp-server repository