shopify-store-mcp

A Model Context Protocol (MCP) server that lets AI agents (Claude, GPT, etc.) manage Shopify stores. Products, orders, inventory, customers, and analytics — all through natural language.

What It Does

Connect your Shopify store to Claude Desktop, Cursor, or any MCP-compatible AI tool and manage your store with natural language:

• "Show me my top-selling products"
• "Create a new product called 'Summer T-Shirt' at $29.99"
• "How many orders did I get this week?"
• "Adjust inventory for SKU-123, add 50 units"
• "Give me a complete store overview"

Available Tools (16)

Products

Tool	Description
list_products	List products with filters (title, type, status)
get_product	Get detailed product info
create_product	Create new products with variants
update_product	Update product details
delete_product	Remove a product
count_products	Get total product count

Orders

Tool	Description
list_orders	List orders with status/date filters
get_order	Get full order details
count_orders	Count orders by status

Inventory

Tool	Description
list_inventory	View inventory levels
adjust_inventory	Adjust stock quantities
list_locations	List warehouse locations

Customers

Tool	Description
list_customers	Search and list customers
count_customers	Get total customer count

Analytics

Tool	Description
get_shop_info	Store info (plan, currency, etc.)
store_overview	Full dashboard with stats

Quick Start

1. Get Your Shopify Access Token

Go to your Shopify Admin > Settings > Apps and sales channels > Develop apps > Create an app > Configure Admin API scopes.

Required scopes:

• read_products, write_products
• read_orders
• read_inventory, write_inventory
• read_customers

2. Install

npm install -g @xmqywxkris/shopify-store-mcp

Or use directly with npx:

npx @xmqywxkris/shopify-store-mcp

3. Configure with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "@xmqywxkris/shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_your_token_here"
      }
    }
  }
}

4. Configure with Claude Code

claude mcp add shopify -- npx -y shopify-store-mcp \
  --env SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token

Configuration

Variable	Required	Description
SHOPIFY_STORE_DOMAIN	Yes	Your store domain (e.g., mystore.myshopify.com)
SHOPIFY_ACCESS_TOKEN	Yes	Admin API access token
SHOPIFY_API_VERSION	No	API version (default: 2025-01)

Usage Examples

List all active products:

"Show me all active products in my store"

Create a product with variants:

"Create a product called 'Classic Hoodie' with sizes S, M, L, XL at $49.99"

Inventory management:

"Check inventory for all products at the main warehouse and flag anything below 10 units"

Store analytics:

"Give me a store overview — total products, recent orders, and revenue this month"

Bulk operations:

"Update all products in the 'Winter' collection to have a 20% discount"

Use Cases

For Store Owners

• Manage products and inventory through AI chat
• Get quick store analytics and summaries
• Bulk operations via natural language

For Developers

• Build AI-powered Shopify automation
• Integrate store management into AI workflows
• Create custom AI agents for e-commerce

For Agencies

• Manage multiple client stores via AI
• Automate routine store operations
• Generate reports and insights

Development

git clone https://github.com/xmqywx/shopify-store-mcp.git
cd shopify-store-mcp
npm install
npm run dev

Cursor Plugin

Install directly in Cursor IDE:

1. Open Cursor → Settings → Plugins
2. Search "shopify-store-mcp"
3. Click Install
4. Add your Shopify credentials in the MCP server settings

Or manually: clone this repo and open it in Cursor — the plugin auto-discovers.

License

MIT