Shopify MCP Server
(please leave a star if you like!)
MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.
📦 Package Name: shopify-mcp
🚀 Command: shopify-mcp (NOT shopify-mcp-server)
Features
- Product Management: Full CRUD for products, variants, and options (8 tools)
- Customer Management: Full CRUD, merge, and address management (8 tools)
- Order Management: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (10 tools)
- Metafield Management: Get, set, and delete metafields on any resource (3 tools)
- Inventory Management: Set absolute inventory quantities at locations (1 tool)
- Tag Management: Add/remove tags on any taggable resource (1 tool)
- Pagination & Sorting: Cursor-based pagination and sort keys on all list queries
- Advanced Filtering: Pass-through Shopify query syntax for all list endpoints
- GraphQL Integration: Direct integration with Shopify's GraphQL Admin API (2026-01)
- Comprehensive Error Handling: Clear error messages for API and authentication issues
Prerequisites
- Node.js (version 18 or higher)
- A Shopify store with a custom app (see setup instructions below)
Setup
Authentication
This server supports two authentication methods:
Option 1: Client Credentials (Dev Dashboard apps, January 2026+)
As of January 1, 2026, new Shopify apps are created in the Dev Dashboard and use OAuth client credentials instead of static access tokens.
- From your Shopify admin, go to Settings > Apps and sales channels
- Click Develop apps > Build app in dev dashboard
- Create a new app and configure Admin API scopes:
read_products,write_productsread_customers,write_customersread_orders,write_orders
- Install the app on your store
- Copy your Client ID and Client Secret from the app's API credentials
The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).
Option 2: Static Access Token (legacy apps)
If you have an existing custom app with a static shpat_ access token, you can still use it directly.
Usage with Claude Desktop
Client Credentials (recommended):
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"shopify-mcp",
"--clientId",
"<YOUR_CLIENT_ID>",
"--clientSecret",
"<YOUR_CLIENT_SECRET>",
"--domain",
"<YOUR_SHOP>.myshopify.com"
]
}
}
}
Static Access Token (legacy):
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": [
"shopify-mcp",
"--accessToken",
"<YOUR_ACCESS_TOKEN>",
"--domain",
"<YOUR_SHOP>.myshopify.com"
]
}
}
}
Locations for the Claude Desktop config file:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
Usage with Claude Code
Client Credentials:
claude mcp add shopify -- npx shopify-mcp \
--clientId YOUR_CLIENT_ID \
--clientSecret YOUR_CLIENT_SECRET \
--domain your-store.myshopify.com
Static Access Token (legacy):
claude mcp add shopify -- npx shopify-mcp \
--accessToken YOUR_ACCESS_TOKEN \
--domain your-store.myshopify.com
Alternative: Run Locally with Environment Variables
If you prefer to use environment variables instead of command-line arguments:
-
Create a
.envfile with your Shopify credentials:Client Credentials:
SHOPIFY_CLIENT_ID=your_client_id SHOPIFY_CLIENT_SECRET=your_client_secret MYSHOPIFY_DOMAIN=your-store.myshopify.comStatic Access Token (legacy):
SHOPIFY_ACCESS_TOKEN=your_access_token MYSHOPIFY_DOMAIN=your-store.myshopify.com -
Run the server with npx:
npx shopify-mcp
Direct Installation (Optional)
If you want to install the package globally:
npm install -g shopify-mcp
Then run it:
shopify-mcp --clientId=<ID> --clientSecret=<SECRET> --domain=<YOUR_SHOP>.myshopify.com
Additional Options
--apiVersion: Specify the Shopify API version (default:2026-01). Can also be set viaSHOPIFY_API_VERSIONenvironment variable.
⚠️ Important: If you see errors about "SHOPIFY_ACCESS_TOKEN environment variable is required" when using command-line arguments, you might have a different package installed. Make sure you're using shopify-mcp, not shopify-mcp-server.
Available Tools (31)
Pagination, Sorting & Filtering
All list query tools (get-products, get-customers, get-orders, get-customer-orders) support:
- Cursor-based pagination:
after/before(cursor strings), withpageInfoin the response (hasNextPage,hasPreviousPage,startCursor,endCursor) - Sorting:
sortKey(enum specific to each resource) andreverse(boolean) - Advanced filtering:
queryorsearchQueryparameter accepting Shopify query syntax
Product Management (8 tools)
-
get-products- Get all products or search by title with pagination and sorting
- Inputs:
searchTitle(string, optional): Filter products by title (wraps intitle:*...*)limit(number, default: 10): Maximum number of products to returnquery(string, optional): Raw Shopify query string (e.g."status:active vendor:Nike tag:sale")sortKey(string, optional): One ofCREATED_AT,ID,INVENTORY_TOTAL,PRODUCT_TYPE,PUBLISHED_AT,RELEVANCE,TITLE,UPDATED_AT,VENDORreverse(boolean, optional): Reverse the sort orderafter/before(string, optional): Pagination cursors
-
get-product-by-id- Get a specific product by ID with full details including SEO, options, media, variants, and collections
- Inputs:
productId(string, required): Shopify product GID
- Returns:
productType,descriptionHtml,seo,options(withoptionValues),media(images),variants,collections,tags,vendor, price range, inventory
-
create-product- Create a new product. When using
productOptions, Shopify registers all option values but only creates one default variant (first value of each option, price $0). Usemanage-product-variantswithstrategy: REMOVE_STANDALONE_VARIANTafterward to create all real variants with prices. - Inputs:
title(string, required): Title of the productdescriptionHtml(string, optional): Description with HTMLhandle(string, optional): URL slug. Auto-generated from title if omittedvendor(string, optional): Vendor of the productproductType(string, optional): Type of the product- (array of strings, optional): Product tags
- Create a new product. When using
Customer Management (8 tools)
-
get-customers- List customers with search, pagination, and sorting
- Inputs:
searchQuery(string, optional): Freetext or Shopify query syntax (e.g."country:US tag:vip orders_count:>5")limit(number, default: 10): Maximum number of customers to returnsortKey(string, optional): One ofCREATED_AT,ID,LAST_UPDATE,LOCATION,NAME,ORDERS_COUNT,RELEVANCE,TOTAL_SPENT,UPDATED_ATreverse(boolean, optional): Reverse the sort orderafter/before(string, optional): Pagination cursors
-
get-customer-by-id- Get a single customer by ID with full details
- Inputs:
id(string, required): Shopify customer ID (numeric only, e.g."6276879810626")
- Returns: name, email, phone, addresses, tags, note, tax status, amount spent, order count, metafields
-
create-customer- Create a new customer
- Inputs:
firstName(string, optional): Customer's first namelastName(string, optional): Customer's last nameemail(string, optional): Customer's email addressphone(string, optional): Customer's phone numbertags(array of strings, optional): Tags to applynote(string, optional): Note about the customertaxExempt(boolean, optional): Whether the customer is exempt from taxesmetafields(array of objects, optional): Custom metafields (namespace,key,value,type)addresses(array of objects, optional): Customer addresses (address1,address2,city,provinceCode,zip,country,phone)
Order Management (10 tools)
-
get-orders- Get orders with filtering, pagination, and sorting
- Inputs:
status(string, optional):"any","open","closed", or"cancelled". Default"any"limit(number, default: 10): Maximum number of orders to returnquery(string, optional): Raw Shopify query string (e.g."financial_status:paid fulfillment_status:shipped tag:rush")sortKey(string, optional): One ofCREATED_AT,ORDER_NUMBER,TOTAL_PRICE,FINANCIAL_STATUS,FULFILLMENT_STATUS,UPDATED_AT,CUSTOMER_NAME,PROCESSED_AT,ID,RELEVANCEreverse(boolean, optional): Reverse the sort orderafter/before(string, optional): Pagination cursors
-
get-order-by-id- Get a specific order by ID with smart lookup — accepts order name (
#77235or77235), numeric ID (8054938337547), or full GID (gid://shopify/Order/...) - Inputs:
orderId(string, required): Order name, numeric ID, or full GID
- Returns: pricing, customer, shipping/billing addresses, line items, tags, notes, metafields, cancel reason, return status, discount codes, PO number, timestamps
- Get a specific order by ID with smart lookup — accepts order name (
-
update-order- Update an existing order
- Inputs:
id(string, required): Shopify order GIDtags(array of strings, optional): New tags for the orderemail(string, optional): Update customer email on the ordernote(string, optional): Order notesphone(string, optional): Phone number for the orderpoNumber(string, optional): Purchase order numbercustomAttributes(array of objects, optional): Custom key-value attributesmetafields(array of objects, optional): Order metafields
Draft Order Management (1 tool)
-
complete-draft-order- Complete a draft order, converting it into a real order
- Inputs:
draftOrderId(string, required): Draft order GIDpaymentGatewayId(string, optional): Payment gateway GID
Metafield Management (3 tools)
-
get-metafields- Get metafields for any Shopify resource (products, orders, customers, variants, collections, etc.)
- Inputs:
ownerId(string, required): GID of any resourcenamespace(string, optional): Filter by namespacefirst(number, default: 25): Number of metafields to returnafter(string, optional): Pagination cursor
-
set-metafields- Set metafields on any Shopify resource. Creates or updates up to 25 metafields atomically
- Inputs:
metafields(array, required): Metafields to set, each withownerId,key,value, and optionalnamespace,type
-
delete-metafields- Delete metafields from any Shopify resource
- Inputs:
metafields(array, required): Metafields to delete, each withownerId,namespace,key
Inventory Management (1 tool)
-
inventory-set-quantities- Set absolute inventory quantities for items at specific locations
- Inputs:
reason(string, required): Reason for change (e.g."correction","cycle_count_available")name(string, required):"available"or"on_hand"quantities(array, required): Items withinventoryItemId,locationId,quantity
Tag Management (1 tool)
-
manage-tags- Add or remove tags on any taggable resource (orders, products, customers, draft orders, articles)
- Inputs:
id(string, required): GID of the resourcetags(array of strings, required): Tags to add or removeaction(string, required):"add"or"remove"
Order Query Filter Reference
The get-orders tool's query parameter supports Shopify search syntax:
Debugging
If you encounter issues, check Claude Desktop's MCP logs:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
License
MIT
