Log inSubmit server
Shopify Admin MCP logo

Shopify Admin MCP

Manage one Shopify store through MCP tools for products, orders, customers, inventory, discounts, and custom GraphQL.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Shopify Admin MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "shopify-admin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-shopify-admin@latest"
      ],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "YOUR_VALUE_HERE",
        "SHOPIFY_CLIENT_ID": "YOUR_VALUE_HERE",
        "SHOPIFY_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "SHOPIFY_ACCESS_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Shopify Admin MCP MCP server connects an AI client to one Shopify store through the Admin GraphQL API. It provides focused tools for reading shop data and managing products, variant prices, inventory, orders, and basic discounts, plus an escape hatch for arbitrary GraphQL documents. Use it for store operations that fit a single configured shop, while reviewing destructive actions such as order cancellation and custom mutations carefully. The server runs locally over stdio and can obtain short-lived Admin API tokens from Shopify app credentials.

Use cases

  • Inspect recent orders and their fulfillment or financial status
  • Create products and update their fields or variant prices
  • Set available inventory for items at Shopify locations
  • Search customers and review their recent order history
  • Create a basic percentage or fixed-amount discount code

Key features

  • Shopify Admin GraphQL access for one configured store
  • Product, order, customer, inventory, location, and discount tools
  • Cursor pagination with Shopify search queries
  • Automatic Admin token renewal from app credentials
  • Cost bucket details in every response
  • Arbitrary GraphQL queries and mutations

Tools16

What Shopify Admin MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

15/15 checks healthy over the last 72d

What it can do

From the 16 tools this server returned when we ran it; 16 declare their own safety hints.

Can delete or modify data · 2Makes network requests · 16Read-only tools · 14
Network at startup4 connections
Files written at startup1
Install scriptsprepare
npm provenanceNot published
Package age58 days
Maintainers1

Observed 2026-10-20 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11h ago via OSV.dev · mcp-shopify-admin@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.1kPackage downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Tools exposed16Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Shopify Admin MCP works

What Shopify Admin MCP does

Shopify Admin MCP exposes one Shopify store through the Admin GraphQL API and makes common commerce operations available as MCP tools. It can inspect shop details, locations, products, orders, customers, inventory, and discounts. Supported writes include creating and updating products, changing variant prices, setting inventory quantities, cancelling eligible orders, and creating basic promotional codes.

The server is scoped to the store configured in SHOPIFY_STORE_DOMAIN; individual tool calls cannot switch stores. Its graphql_request tool extends coverage to Admin API operations without dedicated wrappers, including metafields, media, collections, webhooks, segments, and bulk operations.

How it works

The server is an npm package launched locally with npx and communicates with MCP clients over stdio. It uses either Shopify Dev Dashboard app credentials or an existing Admin access token. With a client ID and secret, it obtains an Admin API token, holds that token in memory, and renews it before Shopify's 24-hour expiry.

List operations use Shopify search syntax and cursor pagination. Responses include hasNextPage and endCursor; a later call passes the cursor as after. Product, order, and customer lookups accept Shopify numeric IDs or the corresponding GraphQL global IDs. Order numbers such as #1001 must first be located through an order search.

Every result includes GraphQL cost information, including the request cost and the remaining query bucket. Shopify mutation failures are reported through userErrors, even when the HTTP response status is 200. Arbitrary GraphQL mutations are marked destructive and are not automatically retried; throttled requests can be retried after a delay.

Setup and configuration

Use Node.js 20 or newer, a Shopify store domain, and Admin API credentials. The recommended configuration uses a Shopify Dev Dashboard app whose app and store belong to the same Shopify organization. A legacy ready-made token from a custom app can be supplied instead.

Example launch command:

Terminal
npx -y mcp-shopify-admin@latest

Configure the process in an MCP client with these environment variables:

  • SHOPIFY_STORE_DOMAIN — the store domain, such as my-store.myshopify.com.
  • SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET — credentials for the recommended token exchange flow.
  • SHOPIFY_ACCESS_TOKEN — an alternative to the client ID and secret when using an existing token.

The package includes setup examples for Codex, Claude Code, Claude Desktop local configurations, Cursor, and VS Code. Browser-only ChatGPT and Claude web sessions cannot start this local stdio process directly.

Tools and capabilities

The dedicated tools cover the following areas:

  • Read shop information, locations, products, orders, customers, and discounts.
  • Search products, orders, and customers using Shopify query syntax.
  • Create products and update product fields or variant prices.
  • Set absolute available inventory quantities for inventory items at locations.
  • Cancel orders with explicit refund and restock decisions, then inspect the background job result through get_order.
  • Create basic percentage or fixed-amount discount codes.
  • Send custom Admin GraphQL queries or mutations with variables.

Product creation adds a default variant but does not publish the product, set its price, create media, or add inventory. Publication requires a separate Shopify operation through graphql_request. Inventory updates use the inventory item ID, not the variant ID, and set the final available quantity rather than applying a delta.

Limitations and notes

Order cancellation is irreversible, cannot handle fulfilled orders, and does not support partial refunds. Older orders require the read_all_orders scope in addition to read_orders; customer operations require read_customers.

The dedicated discount tool creates only basic, store-wide code discounts. Collection or segment targeting, buy-one-get-one offers, free shipping, and disabling discounts require custom GraphQL operations. Customer records are read-only through the dedicated tools.

GraphQL queries are subject to Shopify's cost limits, and a request costing more than 1,000 points is rejected by Shopify's validator. Deep nested selections can consume the cost bucket quickly. For mutations, callers should inspect userErrors rather than treating HTTP 200 as success.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Shopify Admin MCP

Shopify Admin MCP is an MCP server that connects AI clients to one Shopify store through the Admin GraphQL API. Its main tools read shop, product, order, customer, location, inventory, and discount data, while supporting product, price, inventory, order-cancellation, discount-code, and arbitrary GraphQL operations.

Install it by configuring an MCP client to run `npx -y mcp-shopify-admin@latest` over stdio. Set `SHOPIFY_STORE_DOMAIN` plus either `SHOPIFY_CLIENT_ID` and `SHOPIFY_CLIENT_SECRET`, or an existing `SHOPIFY_ACCESS_TOKEN`. Node.js 20 or newer is required.

Yes, Shopify Admin MCP works with Cursor through its stdio configuration. Add the server to Cursor's MCP configuration, use `npx` with the `mcp-shopify-admin@latest` package, and provide the store domain and Shopify credentials as environment variables.

Yes, `set_inventory` sets the absolute available quantity for inventory items at specified locations. Use the inventory item ID from `get_product` and the location ID from `list_locations`; the operation does not change reservations or record movement history.

No, `create_product` does not publish a product to a sales channel. It creates the product with Shopify's default variant, but publication requires a separate `publishablePublish` operation sent through `graphql_request`.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewShopify Admin MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/shopify-admin-mcp?style=directory)](https://allmcps.com/mcp/shopify-admin-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/shopify-admin-mcp"><img src="https://allmcps.com/api/badge/shopify-admin-mcp?style=directory" alt="Shopify Admin MCP on AllMCPs" /></a>