Overview
What is Shopify MCP Server?
Shopify MCP Server is a Model Context Protocol server that integrates with the Shopify GraphQL Admin API, enabling AI assistants to manage store data. It provides tools for managing products, customers, orders, discounts, draft orders, collections, webhooks, and shop details. It is intended for Shopify store owners and developers who want to interact with their store programmatically via MCP-compatible clients like Claude Desktop.
How to use Shopify MCP Server?
Clone the repository, install dependencies (npm install), create a .env file with SHOPIFY_ACCESS_TOKEN and MYSHOPIFY_DOMAIN, build the project (npm run build), and start the server (npm start). For Claude Desktop, add a configuration entry in claude_desktop_config.json using npx -y shopify-mcp-server and the required environment variables.
Key features of Shopify MCP Server
- Product management with search and retrieval
- Customer data loading and tag management
- Advanced order querying and filtering
- Discount and draft order creation
- Webhook subscription, finding, and unsubscription
Use cases of Shopify MCP Server
- Search for products by title and retrieve detailed variant information
- Query orders with advanced filters, sorting, and pagination
- Create and manage discount codes for promotional campaigns
- Create and complete draft orders with line items and shipping addresses
- Add or remove customer tags for segmentation and marketing
FAQ from Shopify MCP Server
What dependencies does Shopify MCP Server require?
The server depends on @modelcontextprotocol/sdk for MCP, graphql-request for Shopify GraphQL calls, and zod for runtime type validation.
How do I set up authentication for Shopify MCP Server?
Create a custom app in your Shopify admin, configure the required Admin API scopes (read_products, write_products, read_customers, write_customers, read_orders, write_orders), install the app, and copy the Admin API access token. Set SHOPIFY_ACCESS_TOKEN and MYSHOPIFY_DOMAIN in your environment.
How do I run tests for Shopify MCP Server?
Tests use Jest with mocks to avoid real API calls. Run npm test to execute all tests, or npm test -- --coverage for a coverage report.
Where does store data live?
Data is fetched directly from the Shopify API via GraphQL; no data is stored locally by the server.
What transport or authentication method does Shopify MCP Server use?
The server uses HTTP to communicate with the Shopify GraphQL Admin API and authenticates via the Admin API access token provided in the environment variables.
