Shopify MCP Server

Interact with your Shopify store's data using the GraphQL API.

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

- Product Management: Search and retrieve product information
- Customer Management: Load customer data and manage customer tags
- Order Management: Advanced order querying and filtering
- GraphQL Integration: Direct integration with Shopify's GraphQL Admin API
- Comprehensive Error Handling: Clear error messages for API and authentication issues

- Get all products or search by title
- Inputs:

- searchTitle(optional string): Filter products by title
- limit(number): Maximum number of products to return

- Get products from a specific collection
- Inputs:

- collectionId(string): ID of the collection to get products from
- limit(optional number, default: 10): Maximum number of products to return

- Get products by their IDs
- Inputs:

- productIds(array of strings): Array of product IDs to retrieve

- Update product prices for its ID
- Inputs:

- productId(string): ID of the product to update
- price(string): New price for the product

- Get product variants by their IDs
- Inputs:

- variantIds(array of strings): Array of variant IDs to retrieve

- Get shopify customers with pagination support
- Inputs:

- limit(optional number): Maximum number of customers to return
- next(optional string): Next page cursor

- Add tags to a customer
- Inputs:

- customerId(string): Customer ID to tag
- tags(array of strings): Tags to add to the customer

- Get orders with advanced filtering and sorting
- Inputs:

- first(optional number): Limit of orders to return
- after(optional string): Next page cursor
- query(optional string): Filter orders using query syntax
- sortKey(optional enum): Field to sort by ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
- reverse(optional boolean): Reverse sort order

- Get a single order by ID
- Inputs:

- orderId(string): ID of the order to retrieve

- Create a basic discount code
- Inputs:

- title(string): Title of the discount
- code(string): Discount code that customers will enter
- valueType(enum): Type of discount ('percentage' or 'fixed_amount')
- value(number): Discount value (percentage as decimal or fixed amount)
- startsAt(string): Start date in ISO format
- endsAt(optional string): Optional end date in ISO format
- appliesOncePerCustomer(boolean): Whether discount can be used only once per customer

- Create a draft order
- Inputs:

- lineItems(array): Array of items with variantId and quantity
- email(string): Customer email
- shippingAddress(object): Shipping address details
- note(optional string): Optional note for the order

- Complete a draft order
- Inputs:

- draftOrderId(string): ID of the draft order to complete
- variantId(string): ID of the variant in the draft order

- Get all collections
- Inputs:

- limit(optional number, default: 10): Maximum number of collections to return
- name(optional string): Filter collections by name

- Get shop details
- Inputs: None
- Returns: Basic shop information

- Get extended shop details including shipping countries
- Inputs: None
- Returns: Extended shop information including shipping countries

To use this MCP server, you'll need to create a custom app in your Shopify store:
- From your Shopify admin, go toSettings>Apps and sales channels
- ClickDevelop apps(you may need to enable developer preview first)
- ClickCreate an app
- Set a name for your app (e.g., "Shopify MCP Server")
- ClickConfigure Admin API scopes
- Select the following scopes:

- read_products,write_products
- read_customers,write_customers
- read_orders,write_orders

Note: Store your access token securely. It provides access to your store data and should never be shared or committed to version control. More details on how to create a Shopify app can be foundhere.

{ "mcpServers": { "shopify": { "command": "npx", "args": ["-y", "shopify-mcp-server"], "env": { "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>", "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com" } } } }

- Clone the repository
- Install dependencies:

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

- @modelcontextprotocol/sdk - MCP protocol implementation
- graphql-request - GraphQL client for Shopify API
- zod - Runtime type validation

Contributions are welcome! Please read ourContributing Guidelinesfirst.

Built with ❤️ using theModel Context Protocol

A command-line tool for interacting with Shopify's Admin GraphQL API, Functions, and Polaris Web Components.