How do I use shopify-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@shopify-mcp show me unfulfilled orders from the last week" 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

Q: Which integrations are available for this server?

Shopify MCP server provides 36 tools for managing products, orders, customers, inventory, fulfillments, collections, analytics, marketing, content, and webhooks via the Shopify Admin API.

MCP server for the Shopify Admin API — 36 tools for products, orders, customers, inventory, fulfillments, collections, analytics, marketing, content, and webhooks.

npm version TypeScript License: MIT MCP Shopify

Tools

Products (5)

Tool	Description
`list_products`	List/filter products by title, vendor, type, collection, status
`get_product`	Detailed product info with variants, images, metafields
`search_products`	Full-text search across titles, vendors, tags, SKUs
`product_count`	Count products matching filters
`list_collections`	List smart and custom collections

Orders (5)

Tool	Description
`list_orders`	List/filter orders by status, dates, fulfillment
`get_order`	Detailed order with line items, shipping, fulfillments
`recent_orders`	Most recent N orders
`unfulfilled_orders`	Orders waiting for fulfillment
`order_count`	Count orders matching filters

Customers (3)

Tool	Description
`search_customers`	Search by name, email, phone
`get_customer`	Customer details with addresses and order history
`top_customers`	Ranked by total spend or order count

Inventory (4)

Tool	Description
`check_inventory`	Inventory levels across locations for a product
`list_locations`	All warehouse/store locations
`low_stock_products`	Products below inventory threshold
`adjust_inventory`	Adjust inventory at a location

Collections (3)

Tool	Description
`get_collection`	Collection details with product count and rules
`collection_products`	Products within a specific collection
`create_smart_collection`	Create automated collections with rules

Fulfillments (3)

Tool	Description
`list_fulfillments`	Fulfillments for an order with tracking
`create_fulfillment`	Create fulfillment with tracking info
`fulfillment_status_summary`	Order counts by fulfillment status

Analytics (2)

Tool	Description
`store_summary`	Today's orders, revenue, fulfillment breakdown
`sales_by_product`	Revenue and units by product for a date range

Marketing (4)

Tool	Description
`list_price_rules`	List all price rules
`get_price_rule`	Price rule details with conditions
`create_discount_code`	Create discount code for a price rule
`list_discount_codes`	List codes for a price rule

Content (4)

Tool	Description
`list_blogs`	List blog entries
`list_pages`	List store pages
`get_metafields`	Get metafields for any resource
`set_metafield`	Create or update a metafield

Webhooks (3)

Tool	Description
`list_webhooks`	List registered webhooks
`create_webhook`	Register a new webhook
`delete_webhook`	Remove a webhook

Related MCP server: Clind MCP Server

Setup

Install

git clone https://github.com/ExpertVagabond/shopify-mcp.git
cd shopify-mcp
npm install && npm run build

Get a Shopify Access Token

In Shopify admin: Settings > Apps and sales channels > Develop apps
Create app, configure Admin API scopes:
- read_products, write_products, read_orders, write_orders
- read_customers, read_inventory, write_inventory, read_locations
- read_fulfillments, write_fulfillments
Install and copy the Admin API access token

Claude Desktop / Claude Code Config

{
  "mcpServers": {
    "shopify": {
      "command": "node",
      "args": ["/path/to/shopify-mcp/dist/index.js"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Rate Limiting

Built-in Shopify rate limiting:

Monitors X-Shopify-Shop-Api-Call-Limit header
Proactive throttling when approaching the limit
Respects Retry-After on 429 responses
Exponential backoff on 5xx errors
Up to 3 retries for transient failures

Architecture

src/
  index.ts              MCP server setup, 36 tool registrations
  api.ts                Shopify REST client (rate limiting, pagination, retries)
  tools/
    products.ts         Product listing, search, count
    orders.ts           Order listing, details, counts
    customers.ts        Customer search, details, ranking
    inventory.ts        Stock levels, locations, adjustments
    collections.ts      Collection management
    fulfillments.ts     Fulfillment creation, tracking
    analytics.ts        Store summary, sales reports
    marketing.ts        Price rules, discount codes
    content.ts          Blogs, pages, metafields
    webhooks.ts         Webhook management

Built with TypeScript strict mode, @modelcontextprotocol/sdk (stdio transport), Shopify Admin REST API 2024-10, cursor-based pagination, zero external HTTP dependencies.

License

MIT

Author

Built by Purple Squirrel Media

This server cannot be installed

A

license - permissive license

-

quality - not tested

B

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

shopify-mcp

shopify-mcp

Tools

Products (5)

Orders (5)

Customers (3)

Inventory (4)

Collections (3)

Fulfillments (3)

Analytics (2)

Marketing (4)

Content (4)

Webhooks (3)

Setup

Install

Get a Shopify Access Token

Claude Desktop / Claude Code Config

Rate Limiting

Architecture

License

Author

Maintenance

Resources

Latest Blog Posts

MCP directory API