Shopify MCP Server

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(NOTshopify-mcp-server)

- 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
- Node.js (version 18 or higher)
- A Shopify store with a custom app (see setup instructions below)

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 theDev Dashboardand use OAuth client credentials instead of static access tokens.
- From your Shopify admin, go toSettings>Apps and sales channels
- ClickDevelop apps>Build app in dev dashboard
- Create a new app and configureAdmin API scopes:

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

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 staticshpat_access token, you can still use it directly.

{ "mcpServers": { "shopify": { "command": "npx", "args": [ "shopify-mcp", "--clientId", "<YOUR_CLIENT_ID>", "--clientSecret", "<YOUR_CLIENT_SECRET>", "--domain", "<YOUR_SHOP>.myshopify.com" ] } } }

{ "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

claude mcp add shopify -- npx shopify-mcp \ --clientId YOUR_CLIENT_ID \ --clientSecret YOUR_CLIENT_SECRET \ --domain your-store.myshopify.com

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:

SHOPIFY_CLIENT_ID=your_client_id SHOPIFY_CLIENT_SECRET=your_client_secret MYSHOPIFY_DOMAIN=your-store.myshopify.com

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

If you want to install the package globally:

shopify-mcp --clientId=<ID> --clientSecret=<SECRET> --domain=<YOUR_SHOP>.myshopify.com

- --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 usingshopify-mcp, notshopify-mcp-server.

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 acceptingShopify query syntax

- title(string, required): Title of the product
- descriptionHtml(string, optional): Description with HTML
- handle(string, optional): URL slug. Auto-generated from title if omitted
- vendor(string, optional): Vendor of the product
- productType(string, optional): Type of the product
- tags(array of strings, optional): Product tags
- status(string, optional):"ACTIVE","DRAFT", or"ARCHIVED". Default"DRAFT"
- seo(object, optional):{ title, description }for search engines
- metafields(array of objects, optional): Custom metafields (namespace,key,value,type)
- productOptions(array of objects, optional): Options to create inline, e.g.[{ name: "Size", values: [{ name: "S" }, { name: "M" }] }]. Max 3 options.
- collectionsToJoin(array of strings, optional): Collection GIDs to add the product to

- Update an existing product's fields
- Inputs:

- id(string, required): Shopify product GID
- title(string, optional): New title
- descriptionHtml(string, optional): New description
- handle(string, optional): New URL slug
- vendor(string, optional): New vendor
- productType(string, optional): New product type
- tags(array of strings, optional): New tags (overwrites existing)
- status(string, optional):"ACTIVE","DRAFT", or"ARCHIVED"
- seo(object, optional):{ title, description }for search engines
- metafields(array of objects, optional): Metafields to set or update
- collectionsToJoin(array of strings, optional): Collection GIDs to add the product to
- collectionsToLeave(array of strings, optional): Collection GIDs to remove the product from
- redirectNewHandle(boolean, optional): If true, old handle redirects to new handle

- Delete a product
- Inputs:

- id(string, required): Shopify product GID

- Create, update, or delete product options (e.g. Size, Color)
- Inputs:

- productId(string, required): Shopify product GID
- action(string, required):"create","update", or"delete"
- variantStrategy(string, optional):"LEAVE_AS_IS"(default) or"CREATE"— controls whether new variant combinations are generated when adding options
- Foraction: "create":

- options(array, required): Options to create, e.g.[{ name: "Size", values: ["S", "M", "L"] }]

- optionId(string, required): Option GID to update
- name(string, optional): New name for the option
- position(number, optional): New position
- valuesToAdd(array of strings, optional): Values to add
- valuesToDelete(array of strings, optional): Value GIDs to remove

- optionIds(array of strings, required): Option GIDs to delete

- Create or update product variants in bulk
- Inputs:

- productId(string, required): Shopify product GID
- strategy(string, optional): How to handle the default variant when creating."DEFAULT"(removes "Default Title" automatically),"REMOVE_STANDALONE_VARIANT"(recommended for full control), or"PRESERVE_STANDALONE_VARIANT"
- variants(array, required): Variants to create or update. Each variant:

- id(string, optional): Variant GID for updates. Omit to create new
- price(string, optional): Price, e.g."49.00"
- compareAtPrice(string, optional): Compare-at price for showing discounts
- sku(string, optional): SKU (mapped toinventoryItem.sku)
- tracked(boolean, optional): Whether inventory is tracked. Setfalsefor print-on-demand
- taxable(boolean, optional): Whether the variant is taxable
- barcode(string, optional): Barcode
- weight(number, optional): Weight of the variant
- weightUnit(string, optional):"GRAMS","KILOGRAMS","OUNCES", or"POUNDS"
- optionValues(array, optional): Option values, e.g.[{ optionName: "Size", name: "A4" }]

- Delete one or more variants from a product
- Inputs:

- productId(string, required): Shopify product GID
- variantIds(array of strings, required): Variant GIDs to delete

- 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 return
- sortKey(string, optional): One ofCREATED_AT,ID,LAST_UPDATE,LOCATION,NAME,ORDERS_COUNT,RELEVANCE,TOTAL_SPENT,UPDATED_AT
- reverse(boolean, optional): Reverse the sort order
- after/before(string, optional): Pagination cursors

- Get a single customer by ID with full details
- Inputs:

- id(string, required): Shopify customer ID (numeric only, e.g."6276879810626")

- Create a new customer
- Inputs:

- firstName(string, optional): Customer's first name
- lastName(string, optional): Customer's last name
- email(string, optional): Customer's email address
- phone(string, optional): Customer's phone number
- tags(array of strings, optional): Tags to apply
- note(string, optional): Note about the customer
- taxExempt(boolean, optional): Whether the customer is exempt from taxes
- metafields(array of objects, optional): Custom metafields (namespace,key,value,type)
- addresses(array of objects, optional): Customer addresses (address1,address2,city,provinceCode,zip,country,phone)

- Delete a customer
- Inputs:

- id(string, required): Shopify customer ID (numeric only, e.g."6276879810626")

- Merge two customer records into one
- Inputs:

- customerOneId(string, required): GID of the first customer
- customerTwoId(string, required): GID of the second customer
- overrideFields(object, optional): Override which fields to keep from which customer (firstName, lastName, email, phone, defaultAddress, note, tags)

- Create, update, or delete a customer's mailing address
- Inputs:

- customerId(string, required): Customer GID
- action(string, required):"create","update", or"delete"
- addressId(string, optional): Address GID (required for update/delete)
- address(object, optional): Address fields (required for create/update):address1,address2,city,company,countryCode,firstName,lastName,phone,provinceCode,zip
- setAsDefault(boolean, optional): Set as customer's default address

- 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 return
- query(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,RELEVANCE
- reverse(boolean, optional): Reverse the sort order
- after/before(string, optional): Pagination cursors

- 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

- Update an existing order
- Inputs:

- id(string, required): Shopify order GID
- tags(array of strings, optional): New tags for the order
- email(string, optional): Update customer email on the order
- note(string, optional): Order notes
- phone(string, optional): Phone number for the order
- poNumber(string, optional): Purchase order number
- customAttributes(array of objects, optional): Custom key-value attributes
- metafields(array of objects, optional): Order metafields
- shippingAddress(object, optional): Shipping address fields

- Get orders for a specific customer with pagination and sorting
- Inputs:

- customerId(string, required): Shopify customer ID (numeric only, e.g."6276879810626")
- limit(number, default: 10): Maximum number of orders to return
- sortKey(string, optional): Same sort keys asget-orders
- reverse(boolean, optional): Reverse the sort order
- after/before(string, optional): Pagination cursors

- Cancel an order with options for refunding, restocking, and customer notification.Irreversible.
- Inputs:

- orderId(string, required): Order GID
- reason(string, required):"CUSTOMER","DECLINED","FRAUD","INVENTORY","OTHER", or"STAFF"
- restock(boolean, required): Whether to restock inventory
- notifyCustomer(boolean, default: false): Notify the customer
- staffNote(string, optional): Internal note
- refund(boolean, optional): Refund to original payment method

- Close or reopen an order
- Inputs:

- orderId(string, required): Order GID
- action(string, required):"close"or"open"

- Mark an order as paid (for manual/offline payments)
- Inputs:

- orderId(string, required): Order GID

- Create a fulfillment (mark items as shipped) with optional tracking
- Inputs:

- lineItemsByFulfillmentOrder(array, required): Fulfillment orders and line items to fulfill
- trackingInfo(object, optional):{ number, url, company }tracking details
- notifyCustomer(boolean, default: false): Send shipping notification

- Create a full or partial refund with optional restocking
- Inputs:

- orderId(string, required): Order GID
- refundLineItems(array, optional): Line items to refund withlineItemId,quantity,restockType(CANCEL/RETURN/NO_RESTOCK),locationId
- shipping(object, optional):{ amount, fullRefund }shipping refund
- note(string, optional): Refund note
- notify(boolean, optional): Send refund notification

- Create a draft order for phone/chat sales, invoicing, or wholesale
- Inputs:

- lineItems(array, required): Product variants (variantId) or custom items (title+ price). Max 499
- customerId(string, optional): Customer GID
- email,phone,note,tags,poNumber(optional)
- shippingAddress,billingAddress(objects, optional)
- appliedDiscount(object, optional):{ title, value, valueType }order-level discount

- Complete a draft order, converting it into a real order
- Inputs:

- draftOrderId(string, required): Draft order GID
- paymentGatewayId(string, optional): Payment gateway GID

- Get metafields for any Shopify resource (products, orders, customers, variants, collections, etc.)
- Inputs:

- ownerId(string, required): GID of any resource
- namespace(string, optional): Filter by namespace
- first(number, default: 25): Number of metafields to return
- after(string, optional): Pagination cursor

- 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 from any Shopify resource
- Inputs:

- metafields(array, required): Metafields to delete, each withownerId,namespace,key

- 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

- Add or remove tags on any taggable resource (orders, products, customers, draft orders, articles)
- Inputs:

- id(string, required): GID of the resource
- tags(array of strings, required): Tags to add or remove
- action(string, required):"add"or"remove"

Theget-orderstool'squeryparameter supportsShopify search syntax:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Integrate with the GetYourGuide Partner API to access travel activities and experiences.