Shopify MCP: Documentation
Updated:
Connection
npx shopify-mcp --clientId=ID --clientSecret=SECRET --domain=store.myshopify.com (for Dev Dashboard apps, January 2026+, token auto-refreshes) or npx shopify-mcp --accessToken=shpat_... --domain=store.myshopify.com (a static token from legacy custom apps). Create the app in Shopify admin → Settings → Apps and sales channels → Develop apps, with Admin API scopes read/write_products, read/write_customers, read/write_orders.
Tools
31 tools across 6 groups:
- Products — full CRUD for products, variants and options (8 tools).
- Customers — CRUD, duplicate merging, address management (8).
- Orders — smart lookup, cancellation, close/open, marking paid, fulfillment, refunds (10).
- Metafields — get, set, delete on any resource (3).
- Inventory — set an absolute stock quantity (1).
- Tags — add/remove tags on any taggable resource (1).
List queries support cursor-based pagination, sort keys and native Shopify query syntax.
Agent flow
"Find order #1042 and refund one of its items", "update SKU-221's stock at the Moscow location to 40 units", "merge duplicate customers by email", "tag every customer who's spent over $500 as VIP".
Important
This is an unofficial community server: custom-app credentials grant write access to a real store (canceling orders, refunds, stock changes). Scope the Admin API to only the permissions you need, and test flows on a dev store before connecting a live one.
Pricing
The MCP server is free and open source; Shopify itself is billed per the merchant's own plan (fees and subscription are unrelated to using the MCP).