shopify

This Shopify MCP Server provides a GraphQL-driven bridge to a Shopify store, exposing tools to manage products, customers, orders, and more through the Model Context Protocol. It supports operations such as getting products (with optional title search), fetching products by collection or IDs, retrieving variant details, managing customers with pagination and tagging, querying orders with advanced filters, creating discounts and draft orders, and handling collections, shop details, and webhooks. The server is designed to be used with Claude Desktop and similar MCP-enabled tooling, allowing you to craft rich queries against your Shopify data via the included tool set. To start using it, configure your Shopify access token and store domain, then invoke the provided tools to fetch, filter, or mutate data as described in each tool’s inputs and return structure.

Prerequisites:

• Node.js and npm installed on your machine
• Access to a Shopify store and a created custom app with the necessary API scopes

Steps:

1. Clone the repository:

git clone <repository-url>
cd <repository-directory>

2. Install dependencies:

npm install

3. Create a local environment file (optional but recommended):

# .env
SHOPIFY_ACCESS_TOKEN=your_access_token
MYSHOPIFY_DOMAIN=your-store.myshopify.com

4. Build the project (if applicable):

npm run build

5. Run tests (optional):

npm test

6. Run the server locally or via your MCP orchestration (see mcp_config in the README):

npm start

Configure your MCP client (e.g., Claude Desktop) to point to the server using the provided mcp_config snippet and replace the placeholder values with your actual Shopify access token and store domain.

Tips and notes:

• Store your Shopify access token securely; do not commit it to version control.
• The mcp_config example uses npx to run the shopify-mcp-server package; ensure the package name matches the actual published package for your server.
• If you encounter GraphQL request limits or authentication errors, verify that the access token has the required scopes and that the store domain is correct.
• You can customize environment variables (e.g., to switch stores or tokens) without changing the codebase.
• Ensure network access and firewall rules allow outbound requests to Shopify’s GraphQL Admin API.
• Review the supported tools in the README to understand the exact inputs and return formats for each operation.