MCP Shopify Admin Server

An MCP (Model Context Protocol) server that exposes Shopify Admin API capabilities to LLMs like Claude.

Features

• Products: List, get, create, and update products

• Orders: List, get, fulfill, and cancel orders

• Customers: List and get customer details

• Inventory: Get inventory levels and adjust quantities

Prerequisites

• Node.js 18+

• A Shopify store with Admin API access

• An Admin API access token with the required scopes

Required API Scopes

Your Shopify Admin API access token needs these scopes:

• read_products, write_products

• read_orders, write_orders

• read_customers, write_customers

• read_inventory, write_inventory

• read_locations

Installation

1. Clone this repository:

   git clone https://github.com/your-org/mcp-shopify-admin.git
   cd mcp-shopify-admin

2. Install dependencies:

   npm install

3. Create a .env file with your Shopify credentials:

   cp .env.example .env

4. Edit .env with your store domain and access token:

   SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
   SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Usage

With Claude Desktop

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

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

With MCP Inspector

Test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector node src/index.js

Standalone

Run the server directly (for debugging):

npm start

Available Tools

Products

Orders

Customers

Inventory

Response Formats

All tools support two response formats via the response_format parameter:

• json (default): Structured JSON for programmatic use

• markdown: Human-readable formatted output

Examples

List Products

Use shopify_list_products to show me the first 10 products

Get Order Details

Use shopify_get_order with id "5123456789" and response_format "markdown"

Update Inventory

Use shopify_update_inventory to add 50 units to inventory item "12345" at location "67890"

Error Handling

The server provides clear error messages for common issues:

• 401 Unauthorized: Check your access token

• 403 Forbidden: Your token may lack required scopes

• 429 Rate Limited: Wait before making more requests

• 404 Not Found: The requested resource doesn't exist

License

MIT