Shopify Admin MCP

A1 Shopify Admin MCP connects an AI app to your Shopify store's admin via the Admin API (GraphQL). It helps you work with products and prices, orders, customers, inventory, and promo codes — in natural language.

The server is bound to a single store: the domain is set by configuration, the token is the custom app's Admin API access token, and no tool can reach into another store.

• 16 tools. Store, products and variants, orders, customers, locations, inventory, discounts — plus a raw GraphQL request for everything else.

• Honest HTTP 200s. Shopify mutations return 200 even on failure; the server reads userErrors and turns a rejection into a clear error. A 200 without a data object — empty, truncated, or not GraphQL at all — also becomes an error instead of an empty result.

• Irreversible actions are visible. Order cancellation (with decisions about refunds and restocking) and the raw GraphQL request are marked as destructive.

• Cost bucket under control. Every response carries cost: how much the request cost and how many points are left in the GraphQL bucket.

Start with a read-only request:

Show me the store's latest orders and the top products with inventory.

Connect the server · See what you can delegate · Open documentation

See it work in a minute

You: Show me the store's recent orders and the top products with inventory.

Assistant: Displays orders with statuses and totals, and products with prices and inventory counts. Nothing changes.

You: Prepare a 20% discount with the promo code SUMMER for two weeks.

Assistant: Shows the future promo code's parameters — code, amount, duration, limits — and asks for confirmation.

You: Confirmed.

• Quick start

• What you can delegate

• What might change

• Getting access

• Configuration

• Data, limits, and background operation

• Technical documentation

• Support

Quick start

You'll need Node.js 20+, a store domain like my-store.myshopify.com, and an Admin API access token for a custom app (shpat_…). Creating an app requires store owner permissions or staff permissions to develop apps.

1. Get access.

2. Add the server to your AI app.

3. Send the safe first request shown above.

In Settings → Plugins → MCP servers click Add server, then add npx -y mcp-shopify-admin@latest with SHOPIFY_STORE_DOMAIN and SHOPIFY_ACCESS_TOKEN.

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Codex MCP documentation

Run claude mcp add to add the server to a project or user scope, then restart the session.

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Claude Code MCP documentation

Open Settings → Developer → Edit Config and add:

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

If Edit Config isn't available, edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows. Claude Desktop MCP documentation

Add {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} to ~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows. Cursor MCP documentation

Run MCP: Open User Configuration and add:

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

Verify the server with MCP: List Servers. VS Code MCP documentation

What you can delegate

• Show this week's orders with payment and fulfillment statuses.

• Find products with no inventory and raise the prices of selected variants.

• Create a new product as a draft and fill in the description.

• Set actual inventory counts after a stocktake.

• Create a promo code for a sale with a usage limit.

• Look up a customer by email and show their recent orders.

What might change

Creating orders, fulfilling shipments, editing customers, publishing products to sales channels, and deleting objects are not part of the toolset — when needed, do it via graphql_request with explicit confirmation.

Getting access

1. Open the store admin: Settings → Apps and sales channels → Develop apps (enable app development if it's off).

2. Create 2 app and on the Configuration tab grant the needed Admin API access scopes: read_products/write_products, read_orders, read_customers, read_locations/write_inventory, read_discounts/write_discounts — depending on your use cases.

3. Install the app and on the API credentials tab copy the 2Admin API access token (shpat_…; shown only once).

4. Pass the ON domain and token as SHOPIFY_STORE_DOMAIN and SHOPIFY_ACCESS_TOKEN.

The token is static and tied to the store. Store it like a password. If you grant new scopes to the app later, Shopify will issue a new token — update the variable and restart the server. A standard development store is handy for safe rehearsals.

Configuration

Data, limits, and background operation

• GraphQL cost bucket. Each query spends points weighted by its cost; the bucket every second. One page with first up to 250 is more efficient than a series of small ones; the server shows cost with each result.

• Transient errors. THROTTLED is retried automatically, waiting per the bucket -> minus math. Mutations are not retried after a network or 5xx error, so the change isn't applied twice.

• Orders older than 60 days require the read_all_orders scope, which Shopify grants on request; without it, old orders just don't come back.

• No continuous monitoring. The server only runs when called. If your AI app supports scheduled tasks, it can periodically check orders and inventory.

• Anonymous telemetry. No secrets, store data, arguments, or prompts are shared; opt out with ASKADS_TELEMETRY=0.

Documentation

• MCP capability catalog — per-tool pages covering user tasks.

• All tools and parameters

• [Literally everything you can do]

• Developer documentation

• Publishing documentation

• Shopify Admin API (GraphQL) documentation

Support

Found a bug or missing an article? File an issue or message us on Telegram.