Shopify MCP Manager
Provides over 30 tools for fully managing a Shopify store, including products, orders, customers, inventory, discounts, analytics, and shop configuration via the Shopify Admin GraphQL API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shopify MCP Manager list my top 5 best-selling products"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Shopify MCP Manager
An MCP (Model Context Protocol) server for fully managing a Shopify store through AI assistants like Cursor or Claude Desktop.
Architecture
┌─────────────────┐ stdio ┌──────────────────┐ GraphQL ┌──────────────┐
│ Cursor / Claude │◄──────────────►│ MCP Server │◄────────────►│ Shopify API │
│ (MCP Client) │ │ (Node.js) │ │ Admin API │
└─────────────────┘ └──────────────────┘ └──────────────┘
│
▼
┌──────────────────┐
│ token-store.json │
│ (Access Token) │
└──────────────────┘OAuth Flow
┌──────────┐ 1. /auth/start ┌──────────────────┐
│ Browser │◄────────────────────►│ OAuth Server │
│ │ │ (localhost:3847) │
└─────┬─────┘ └──────────────────┘
│ ▲
│ 2. Redirect to Shopify │ 5. Save token
▼ │
┌──────────────┐ 3. Authorize ┌──────────────────────────────┐
│ Shopify │───────────────►│ Cloudflare Worker │
│ Grant Screen│ 4. Callback │ (your-oauth-callback. │
└──────────────┘ + Auth Code │ workers.dev) │
│ │ │
│ Redirect to localhost:3847 │
│ /callback │
└──────────────────────────────┘Related MCP server: shopify-graphql-mcp
Prerequisites
Node.js >= 18
A Shopify App (created in the Dev Dashboard)
A Cloudflare Worker for URL redirect (OAuth callback)
Quick Start
1. Install dependencies
npm install2. Configuration
Copy .env.example to .env and fill in your values:
cp .env.example .envRequired values from the Shopify Dev Dashboard:
SHOPIFY_API_KEY → Client ID of your app
SHOPIFY_API_SECRET → Client Secret of your app
SHOPIFY_DOMAIN → Your myshopify.com domain
SHOPIFY_REDIRECT_URL → Your Cloudflare Worker callback URL
3. Configure Shopify App
In the Shopify Dev Dashboard under your app:
Set App URL to your Cloudflare Worker domain (e.g.
https://your-oauth-callback.workers.dev)Add Allowed redirection URLs:
https://your-oauth-callback.workers.dev/callback
4. Configure Cloudflare Worker
Your Cloudflare Worker must redirect OAuth callbacks from Shopify to your local server.
Example Worker:
export default {
async fetch(request: Request): Promise<Response> {
const url = new URL(request.url);
// OAuth callback from Shopify → Redirect to local server
if (url.pathname === "/callback") {
const localUrl = `http://localhost:3847/callback${url.search}`;
return Response.redirect(localUrl, 302);
}
// App URL request from Shopify → Redirect to local server
if (url.searchParams.has("shop")) {
const localUrl = `http://localhost:3847${url.pathname}${url.search}`;
return Response.redirect(localUrl, 302);
}
return new Response("Shopify OAuth Endpoint active.", { status: 200 });
},
};5. Run OAuth
npm run oauthThis starts a local server and opens the browser. Log in to Shopify and grant the permissions. The access token is automatically saved to token-store.json.
6. Configure MCP Server in Cursor
Add the following to your Cursor configuration (~/.cursor/mcp.json):
{
"mcpServers": {
"shopify-manager": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/src/mcp-server.js"],
"env": {
"SHOPIFY_DOMAIN": "your-store.myshopify.com",
"SHOPIFY_API_VERSION": "2026-01"
}
}
}
}Available Tools (30+)
Shop Management
Tool | Description |
| Shop basics (name, domain, plan, currency) |
| Configured languages |
| Privacy, terms of service, refund policies |
| Shipping destinations |
Products
Tool | Description |
| List products with filtering & pagination |
| Product details with variants & images |
| Create a new product |
| Update a product |
| Delete a product |
| List collections |
Orders
Tool | Description |
| List orders with filtering |
| Order details |
| Update an order |
| Cancel an order |
| Create a draft order |
Customers
Tool | Description |
| List customers |
| Customer details |
| Create a new customer |
| Update a customer |
| Delete a customer |
Inventory
Tool | Description |
| List locations |
| Show inventory levels |
| Adjust inventory |
| Full product inventory |
Discounts
Tool | Description |
| List discount codes |
| Create a discount code |
| List automatic discounts |
Analytics
Tool | Description |
| Count orders |
| Count products |
| Count customers |
| Dashboard overview |
| Run arbitrary GraphQL queries |
OAuth Flow Details
The OAuth 2.0 Authorization Code Grant flow works as follows:
Initiation: User starts the OAuth flow via
http://localhost:3847/auth/startRedirect to Shopify: The app redirects the user to Shopify's authorization page with:
client_id(App API Key)scope(requested permissions)redirect_uri(Cloudflare Worker URL)state(nonce for CSRF protection)
User authorizes: The store owner grants the requested permissions
Callback: Shopify sends an authorization code to the redirect_uri
Cloudflare Worker: Redirects the callback to the local OAuth server
Security checks:
HMAC verification (message authenticity from Shopify)
State/nonce comparison (CSRF protection)
Shop domain validation
Token exchange: The authorization code is exchanged for an access token via
POST https://{shop}/admin/oauth/access_tokenPersistence: The token is saved to
token-store.json
Security Notes
Never commit
token-store.jsonor.env(both are in.gitignore)The
SHOPIFY_API_SECRETis confidentialAccess tokens have the permissions of the configured scopes
If you suspect token compromise: rotate the token via the Shopify Dev Dashboard
License
MIT
Available Tools
32 toolsadjust_inventoryB
Adjusts the inventory of an item at a location (increase or decrease)
Inputs: delta (required), locationId (required), inventoryItemId (required), reason.
available_shipping_countriesA
Lists all countries the shop ships to
Inputs: no named parameters.
cancel_orderC
Cancels an order
Inputs: id (required), reason, refund, notifyCustomer.
create_basic_discountB
Creates a percentage or fixed amount discount code
Inputs: code (required), title (required), amount, endsAt, +4 more.
create_customerB
Creates a new customer
Inputs: email (required), note, tags, phone, +3 more.
create_draft_orderC
Creates a draft order
Inputs: lineItems (required), note, tags, customerId.
create_productB
Creates a new product in the shop
Inputs: title (required), tags, status, vendor, +2 more.
delete_customerA
Deletes a customer (WARNING: cannot be undone!)
Inputs: id (required).
delete_productA
Deletes a product from the shop (WARNING: cannot be undone!)
Inputs: id (required).
get_customerB
Gets detailed information about a single customer
Inputs: id (required).
get_customer_countA
Counts customers in the shop
Inputs: no named parameters.
get_inventory_levelsA
Shows inventory quantities for a product at all locations
Inputs: inventoryItemId (required).
get_orderB
Gets detailed information about a single order
Inputs: id (required).
get_order_countA
Counts orders, optionally filtered by status or date range
Inputs: query.
get_productA
Gets detailed information about a single product by its ID
Inputs: id (required).
get_product_countA
Counts products in the shop
Inputs: no named parameters.
get_product_inventoryB
Shows the full inventory of a product with all variants
Inputs: productId (required).
graphql_queryA
Executes an arbitrary GraphQL query against the Shopify Admin API. For advanced queries not covered by other tools.
Inputs: query (required), variables.
list_automatic_discountsD
Lists automatic discounts
Inputs: first.
list_collectionsB
Lists all collections in the shop
Inputs: first, query.
list_customersB
Lists customers in the shop. Filterable by name, email, etc.
Inputs: after, first, query.
list_discount_codesC
Lists all discount codes in the shop
Inputs: first, query.
list_locationsB
Lists all locations of the shop
Inputs: first.
list_ordersA
Lists orders in the shop. Filterable by status, date, etc.
Inputs: after, first, query, reverse, +1 more.
list_productsB
Lists products in the shop. Supports pagination and filtering by title, status, etc.
Inputs: after, first, query.
shop_dashboard_summaryA
Returns a compact overview of the shop: product, order, and customer counts
Inputs: no named parameters.
shop_infoA
Returns basic information about the Shopify shop (name, domain, email, plan, currency, etc.)
Inputs: no named parameters.
shop_localesA
Lists all configured languages/locales of the shop
Inputs: no named parameters.
shop_policiesA
Returns the shop policies (privacy, terms of service, refund, shipping, etc.)
Inputs: no named parameters.
update_customerB
Updates an existing customer
Inputs: id (required), note, tags, email, +3 more.
update_orderC
Updates an order (notes, tags, email, etc.)
Inputs: id (required), note, tags, email.
update_productC
Updates an existing product
Inputs: id (required), tags, title, status, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Most tools have a clear resource-action distinction (products, orders, customers), but there is some overlap between inventory tools (get_inventory_levels vs get_product_inventory) and count tools vs shop_dashboard_summary. Descriptions help clarify, but a few could cause misselection.
The dominant pattern is verb_noun (list_*, get_*, create_*, update_*, delete_*), but exceptions like shop_info, available_shipping_countries, and graphql_query break the pattern. Also, get_product_inventory and get_inventory_levels invert the noun order, creating minor inconsistency.
With 32 tools, this exceeds the 25+ threshold considered 'too many' in the calibration. While Shopify has many domains, the count feels heavy; some tools like get_product_count, get_order_count, and get_customer_count could be consolidated into a single metrics tool.
Core resources (products, orders, customers) have solid CRUD coverage, but collections are only listable, discounts lack update/delete, normal order creation is missing (only draft), and variant-level management is absent. These are notable gaps for a Shopify management server.
Maintenance
Related MCP Connectors
Run your Shopify store with AI: drafts you approve, what to fix, and how your store is doing.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Connect AI to store orders, products and inventory with scoped access and human approvals.
Unofficial Shopify MCP Pack — wraps the Shopify Admin REST API (2024-01)
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to access and manage Shopify store data including products, orders, inventory, and analytics through the Model Context Protocol. It allows users to query store performance and customer details using natural language.-
- AlicenseCqualityDmaintenanceA Model Context Protocol server that provides comprehensive access to the Shopify Admin GraphQL API, enabling AI assistants to manage Shopify stores programmatically.1001MIT
- FlicenseNot gradedqualityDmaintenanceAI-powered Shopify Admin via Claude + MCP, enabling full store management through conversation including products, collections, analytics, and bulk operations.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Shopify stores via natural language, with tools for products, orders, inventory, customers, and analytics.11 npmMIT