shopify

This MCP server provides a bridge to the Shopify Admin GraphQL API via a curated set of tools that let you browse, create, update, and delete Shopify data. The server exposes a collection of commands for managing products, collections, customers, orders, draft orders, inventory, locations, metafields, URL redirects, and more. You can run the server through the MCP client configuration (as shown in the npm setup) or via an access token to start interacting with your Shopify store. Once connected, you can invoke the available tool actions to perform common store management tasks from your MCP client interface, including bulk operations and analytics views.

Prerequisites:

• Node.js 18+ (with npm)
• Access to a Shopify custom app and an Admin API access token (or OAuth flow configured data)

Installation steps:

1. Ensure Node.js and npm are installed:
   • Check: node -v and npm -v
2. Install and run the MCP client using npx (no permanent installation required):
   • For OAuth flow setup, follow the OAuth sequence in the README to obtain an access token and domain, then run:

npx shopify-mcp --oauth --domain=your-store.myshopify.com --clientId=xxx --clientSecret=yyy

• Tokens will be stored at ~/.shopify-mcp/tokens.json. After obtaining a token, start the server with just the domain:

npx shopify-mcp --domain=your-store.myshopify.com

3. Alternative: use an existing access token directly for quick setup:

npx shopify-mcp --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

4. If you plan to integrate with Claude Desktop (or another MCP client), use the configuration example provided in the README (see mcp_config example above).

Tips and troubleshooting:

• Environment variables: you can also provide SHOPIFY_ACCESS_TOKEN and MYSHOPIFY_DOMAIN to the MCP client for convenience. Optional OAuth-related vars include SHOPIFY_CLIENT_ID, SHOPIFY_CLIENT_SECRET, and SHOPIFY_SCOPES.
• Tokens are stored locally (e.g., ~/.shopify-mcp/tokens.json) when using OAuth. If you switch stores or reconstruct the flow, ensure the token file contains a valid access token.
• If you encounter permission or scope errors, re-check the Admin API scopes in your Shopify app and ensure the token has the required permissions (read/write of products, customers, orders, etc.).
• For CLI usage, the server supports a wide range of tools as listed in the Tool catalog (Products, Collections, Customers, Orders, Draft Orders, Inventory, Locations, Metafields, URL redirects, Analytics, and Bulk Operations).
• When using OAuth, you can omit --accessToken after completing the flow and starting the server with just --domain.