Shopify MCP Server

An MCP (Model Context Protocol) server that connects Claude to your Shopify store via the Admin REST API. Provides read-only tools for searching orders, checking inventory, looking up customers, and generating sales summaries.

Tools

| Tool | Description | |------|-------------| | search_orders | Search orders by status, date range, or customer email | | check_inventory | Look up inventory levels by product title or ID | | lookup_customer | Find customers by email, name, or phone | | get_sales_summary | Revenue summary with top products for a date range |

Quick Start

1. Install

npm install -g @buildwithabid/shopify-mcp-server

Or clone locally:

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

2. Configure

Create a custom app at dev.shopify.com with these Admin API scopes:

• read_orders
• read_products
• read_customers

For apps created after Jan 2026 (Dev Dashboard — tokens auto-refresh every 24h):

export SHOPIFY_STORE_URL=https://your-store.myshopify.com
export SHOPIFY_CLIENT_ID=your_client_id
export SHOPIFY_CLIENT_SECRET=your_client_secret

Get your client_id and client_secret from Dev Dashboard → your app → Settings → Client credentials. The server handles token generation and refresh automatically.

For legacy apps (static token):

export SHOPIFY_STORE_URL=https://your-store.myshopify.com
export SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

3. Run

shopify-mcp-server
# Server starts at http://localhost:3000/mcp

4. Add to Claude Code

claude mcp add shopify-mcp --transport http http://localhost:3000/mcp

Then ask Claude things like:

"Show me all open orders from last week"

"Is the Blue T-Shirt XL in stock?"

"Look up customer [email protected]"

"What was our revenue last month?"

Docker

docker build -t shopify-mcp .
docker run -p 3000:3000 \
  -e SHOPIFY_ACCESS_TOKEN=shpat_xxx \
  -e SHOPIFY_STORE_URL=https://your-store.myshopify.com \
  shopify-mcp

Development

cp .env.example .env    # fill in your credentials
npm run dev             # runs with tsx

License

MIT