Shopify Storefront MCP Server

A Model Context Protocol (MCP) server that provides access to Shopify Storefront APIs. This server enables AI assistants like Claude to search products, manage shopping carts, and query store policies.

Features

• Product Search: Search the store catalog with context-aware queries
• Cart Management: Create, update, and retrieve shopping carts
• Policy & FAQ Search: Query store policies, shipping info, and FAQs
• No Authentication Required: Uses Shopify's public Storefront MCP endpoint

Installation

Using npx (Recommended)

npx shopify-storefront-mcp-server <shop-domain>

Global Installation

npm install -g shopify-storefront-mcp-server
shopify-storefront-mcp <shop-domain>

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

macOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "shopify-storefront": {
      "command": "npx",
      "args": ["-y", "shopify-storefront-mcp-server", "your-store.myshopify.com"]
    }
  }
}

Replace your-store.myshopify.com with your actual Shopify store domain.

Available Tools

search_shop_catalog

Search for products in the store catalog.

Parameters:

• query (required): The search term
• context (required): Additional context about what the customer is looking for

Example:

Search for "blue running shoes" with context "looking for comfortable shoes for daily jogging"

search_shop_policies_and_faqs

Search store policies and FAQ information.

Parameters:

• query (required): The policy or FAQ question
• context (optional): Additional context

Example:

Search for "return policy" to find information about returns and refunds

get_cart

Retrieve cart contents and checkout URL.

Parameters:

• cart_id (required): The cart identifier

update_cart

Create or modify a shopping cart.

Parameters:

• cart_id (optional): The cart ID to update. Omit to create a new cart
• lines (required): Array of line items with:
  • quantity: Number of items (set to 0 to remove)
  • merchandise_id: The product variant ID
  • line_item_id: Required when updating existing items

Environment Variables

• SHOPIFY_SHOP_DOMAIN: Alternative way to specify the shop domain

Development

Setup

git clone <repository>
cd shopify-storefront-mcp-server
npm install

Build

npm run build

Run locally

npm start -- your-store.myshopify.com

Development mode

npm run dev

How It Works

This server acts as a proxy between MCP clients (like Claude Desktop) and Shopify's Storefront MCP endpoint. It:

1. Receives tool calls from the MCP client
2. Forwards requests to https://{shop}.myshopify.com/api/mcp
3. Returns the results to the client

The Shopify Storefront MCP endpoint is publicly accessible and doesn't require authentication, making it easy to set up.

Compatibility

• Node.js 18+
• Works with any Shopify store that has the Storefront MCP enabled

License

MIT