🛍️ Shopify MCP Server

Connect AI agents (Claude, Cursor, Windsurf) to your Shopify store data via the Model Context Protocol.

What It Does

Shopify MCP gives AI assistants real-time access to your Shopify store — products, orders, inventory, analytics, and customers — through the Model Context Protocol.

Ask your AI assistant things like:

• "What are my top 10 selling products this month?"
• "Show me orders from the last 7 days"
• "Which products are low on stock?"
• "What's my conversion rate this week?"
• "Find repeat customers who spent over $500"

Architecture

┌──────────────┐     MCP Protocol     ┌──────────────────┐     GraphQL     ┌──────────┐
│  AI Agent    │ ◄──────────────────► │  shopify-mcp     │ ◄────────────► │ Shopify  │
│  (Claude,    │   stdio / SSE        │  server          │   Admin API    │ Store    │
│   Cursor)    │                      │                  │                │          │
└──────────────┘                      └──────────────────┘                └──────────┘

Quick Start

Option 1: npm (Self-Hosted)

npm install -g @botsix/shopify-mcp

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "shopify": {
      "command": "shopify-mcp",
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_your_token_here"
      }
    }
  }
}

Option 2: Hosted (Coming Soon)

$19/mo — No setup, no API keys to manage. Just connect and go.

Available Tools

Tool	Description
get_products	List/search products with filters (title, type, vendor, status)
get_orders	Recent orders with revenue summaries and status breakdown
get_inventory	Stock levels across locations, low-stock alerts
get_analytics	Traffic, conversion rates, top sellers, revenue trends
get_customers	Customer segments, repeat buyers, lifetime value stats

Setup: Getting Your Shopify API Key

1. Go to your Shopify admin → Settings → Apps and sales channels
2. Click Develop apps → Create an app
3. Configure Admin API scopes: read_products, read_orders, read_inventory, read_customers, read_analytics
4. Install the app and copy the Admin API access token

Revenue Model

Tier	Price	Features
Free	$0	npm package, self-host, all 5 tools
Pro	$19/mo	Hosted SSE endpoint, dashboard, priority support
Enterprise	Custom	Multi-store, custom tools, SLA

Tech Stack

• TypeScript — Type-safe from API to tools
• @modelcontextprotocol/sdk — Official MCP SDK
• Shopify Admin API — GraphQL for efficient data fetching
• Zod — Runtime validation for all inputs

Development

git clone https://github.com/botsix-workspace/shopify-mcp.git
cd shopify-mcp
npm install
cp .env.example .env  # Add your Shopify credentials
npm run dev

License

MIT © botsix