What is the Shopify MCP server?
Shopify MCP is an MIT licensed Node.js server that links an MCP client to a Shopify store through the GraphQL Admin API. Its tools cover products and variants, customers, orders, draft orders, fulfilments, refunds, metafields, inventory and tags, using client credentials or a legacy access token.
Shopify MCP is a Model Context Protocol server for the Shopify Admin API. It sends GraphQL queries and mutations for you, so an agent can look up orders or edit products by following a plain language request.
The README names the package shopify-mcp and warns not to confuse it with shopify-mcp-server, a different package that expects other environment variables.
What an agent can do with it
- Create, update and delete products, options and variants, with SEO fields and metafields.
- Search customers, merge duplicates and manage addresses.
- Find orders, cancel, close, mark as paid, fulfil and refund them, or create draft orders.
- Read, set and delete metafields on any resource.
- Set inventory quantities and add or remove tags.
Who it is for
Best for
- Store owners who do repeat catalogue edits and want to describe them.
- Support or ops staff looking up orders by status, tag, SKU or discount code.
- Agencies auditing product data across stores.
Not for
- Theme or storefront design. The tools handle store data, not Liquid files.
- Stores where write scopes cannot be limited to a test app.
Use it with UiChemy
This server handles the store. UiChemy works on WordPress, not Shopify themes, so it fits only if you also run a WordPress marketing site, where Composer writes HTML, CSS and JS. Click Get Started on uichemy.com.
Connect Shopify MCP Server: Manage Store Data With an AI Agent to your AI client
npx shopify-mcp --clientId <YOUR_CLIENT_ID> --clientSecret <YOUR_CLIENT_SECRET> --domain <YOUR_SHOP>.myshopify.comCheck the requirements
The README asks for Node.js 18 or higher and a Shopify store with a custom app.
Create the app
From the Shopify admin open Settings, Apps and sales channels, Develop apps, then build an app in the dev dashboard.
Choose scopes
Add the Admin API scopes you need, such as read and write for products, customers and orders. Install the app on the store.
Copy the credentials
Use the client ID and secret. The server exchanges them for a token and refreshes it before the roughly 24 hour expiry. A legacy shpat token still works with the accessToken flag.
Add the config
Paste the block above into your client. You can use environment variables instead, and the apiVersion option defaults to 2026-01.
Client configuration
{
"mcpServers": {
"shopify": {
"command": "npx",
"args": ["shopify-mcp", "--clientId", "<YOUR_CLIENT_ID>", "--clientSecret", "<YOUR_CLIENT_SECRET>", "--domain", "<YOUR_SHOP>.myshopify.com"]
}
}
}Endpoints and ports
<YOUR_CLIENT_ID>Client credentials flow.<YOUR_CLIENT_SECRET>Client credentials flow.<YOUR_ACCESS_TOKEN>Legacy static token option.<YOUR_SHOP>.myshopify.comYour store domain.2026-01Optional. Default is 2026-01.What you can do with it
- GraphQL Admin APICalls use Shopify's GraphQL Admin API, defaulting to the 2026-01 version.
- Two auth routesClient credentials for dev dashboard apps, or a static access token for older custom apps.
- Automatic token refreshClient credentials are exchanged for a token that the server renews before it expires.
- Pagination and sortingList tools support cursors, sort keys and reverse order.
- Shopify query filtersPass search syntax such as status, vendor, tag, SKU or financial status.
- Order lifecycle toolsCancel, close, mark paid, fulfil, refund and draft orders from one server.
- Metafields and tagsRead and write custom data and tags across resource types.
Tools it exposes
get-products / get-product-by-id
List or read products with search, sort and pagination.
create-product / update-product / delete-product
Write product records, including SEO and metafields.
manage-product-options / manage-product-variants
Create or change options and variants in bulk.
get-customers / create-customer / customer-merge
Look up, create and merge customers.
get-orders / get-order-by-id / update-order
Find and edit orders with Shopify search syntax.
order-cancel / order-close-open / order-mark-as-paid
Change order state.
create-fulfillment / refund-create
Fulfil orders and issue refunds.
create-draft-order / complete-draft-order
Build and complete draft orders.
get-metafields / set-metafields / delete-metafields
Work with metafields on any resource.
inventory-set-quantities / manage-tags
Set stock levels and add or remove tags.
Frequently asked questions
What is the Shopify MCP server?
It is an open source Model Context Protocol server, published as the shopify-mcp package, that connects an AI client to a Shopify store through the GraphQL Admin API. It handles products, customers, orders, metafields, inventory and tags, and it is MIT licensed.
How do I install Shopify MCP?
Run npx shopify-mcp with the flags clientId, clientSecret and domain, or the equivalent environment variables, from your MCP client config. Use the package name shopify-mcp, not shopify-mcp-server. Node.js 18 or higher is required.
How does authentication work?
There are two routes. New dev dashboard apps use a client ID and secret that the server exchanges for a token valid for about a day and refreshes itself. Older custom apps can pass a static shpat access token with the accessToken option.
Which scopes should I grant?
The README example lists read and write scopes for products, customers and orders. Start with read scopes only, and add write scopes once you have tested the prompts on a development store, since the tools can delete products and customers.
Can it refund and fulfil orders?
Yes. The README lists tools to create fulfilments and refunds, cancel, close or reopen orders and mark them paid, plus draft order creation and completion. Money related actions deserve a manual check, so try them on a test store first.
Does it support pagination and filters?
Yes. List tools for products, customers and orders support cursors, sort keys and a reverse flag. They also accept a query string in Shopify search syntax, for example status:active or financial_status:paid.
Does it work with WooCommerce?
No, it only talks to Shopify. For a WordPress store, read about the WooCommerce MCP server. For editing store pages built with Elementor, see MCP Abilities Elementor, and Respira spans many builders.
Which API version does it use?
The default is 2026-01, and you can set another version with the apiVersion option or the SHOPIFY_API_VERSION variable. Shopify retires old versions on its own schedule, so pin the version you have tested.


