Shopify MCP Server
MCP Server for Shopify API, enabling interaction with store data (products, customers, orders, etc.) via GraphQL.
Features
Provides tools for product, customer, and order management, direct GraphQL integration, and clear error handling.
Prerequisites
- Node.js (v16+)
- Shopify Custom App Access Token
Installation
Shopify Setup & Configuration
- Create Custom App: In Shopify admin > Settings > Apps and sales channels > Develop apps > Create an app.
- Configure Scopes: Grant
read/write
permissions forproducts
,customers
, andorders
. - Install App & Get Token: Install the app and copy the Admin API access token.
- Create
.env
file in the project root: - Configure Claude Desktop (
claude_desktop_config.json
):- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
Note: Use the correct path to the cloned repo and store your token securely.
- macOS:
Available Tools
Product Management
findProducts
: Get all products or search by title.searchTitle
(optional string): Filter by title.limit
(number): Max products.
listProductsInCollection
: Get products from a collection.collectionId
(string): Collection ID.limit
(optional number, default: 10): Max products.
getProductsByIds
: Get products by IDs.productIds
(array of strings): Product IDs.
getVariantsByIds
: Get variants by IDs.variantIds
(array of strings): Variant IDs.
Customer Management
listCustomers
: Get customers with pagination.limit
(optional number): Max customers.next
(optional string): Next page cursor.
addCustomerTags
: Add tags to a customer.customerId
(string): Customer ID.tags
(array of strings): Tags to add.
Order Management
findOrders
: Get orders with advanced filtering/sorting.first
(optional number): Limit orders.after
(optional string): Next page cursor.query
(optional string): Filter query.sortKey
(optional enum): Sort field.reverse
(optional boolean): Reverse sort.
getOrderById
: Get a single order by ID.orderId
(string): Order ID.
createDraftOrder
: Create a draft order.lineItems
(array): Items (variantId, quantity).email
(string): Customer email.shippingAddress
(object): Shipping details.note
(optional string): Order note.
completeDraftOrder
: Complete a draft order.draftOrderId
(string): Draft order ID.variantId
(string): Variant ID.
Discount Management
createDiscountCode
: Create a basic discount code.title
(string): Discount title.code
(string): Discount code.valueType
(enum): 'percentage' or 'fixed_amount'.value
(number): Discount value.startsAt
(string): Start date (ISO).endsAt
(optional string): End date (ISO).appliesOncePerCustomer
(boolean): Limit one use per customer.
Collection Management
listCollections
: Get all collections.limit
(optional number, default: 10): Max collections.name
(optional string): Filter by name.
Shop Information
getShopDetails
: Get basic shop details (No inputs).getExtendedShopDetails
: Get extended shop details (No inputs).
Webhook Management
manageWebhooks
: Manage webhooks.action
(enum): 'subscribe', 'find', 'unsubscribe'.callbackUrl
(string): Webhook URL.topic
(enum): Webhook topic.webhookId
(optional string): Required for unsubscribe.
Debugging Tools
debugGetVariantMetafield
: Get variant &size_chart_json
metafield.variantId
(string): Variant GID.
Developer Tools
introspect_admin_schema
: Introspect Admin API GraphQL schema.query
(string): Filter term.filter
(optional array): Filter by 'types', 'queries', 'mutations', 'all'.
search_dev_docs
: Search shopify.dev docs.prompt
(string): Search query.
Debugging
Check Claude Desktop MCP logs:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Common issues:
- Authentication: Check token, domain format, API scopes.
- API Errors: Check rate limits, input formats, required fields.
Development
Dependencies
- @modelcontextprotocol/sdk
- graphql-request
- zod
License
MIT
Note: Fork of original shopify-mcp-server repository
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables interaction with Shopify store data (products, customers, orders) via GraphQL, providing comprehensive tools for store management through Claude.
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with Shopify store data using the GraphQL API, supporting product, customer, and order management with comprehensive error handling.Last updated -15767TypeScriptMIT License
- AsecurityAlicenseAqualityEnables interaction with Shopify store data via GraphQL API, providing tools for managing products, customers, orders, discounts, and more with robust error handling.Last updated -157630TypeScriptMIT License
- -securityAlicense-qualityThis MCP server connects clients with Shopify store data, enabling retrieval of product and customer information via exposed tools.Last updated -2PythonMIT License
- AsecurityAlicenseAqualityMCP server that integrates with Shopify API, allowing Claude Desktop users to retrieve and manipulate product information from Shopify stores.Last updated -5PythonMIT License