ajackus/shopify-mcp-server

Shopify MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop to interact with Shopify stores. Access products, orders, customers, inventory, and more through a secure API connection.

Quick Start

Installation

You can run this server directly using npx:

npx @ajackus/shopify-mcp-server

Or install globally:

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

Configuration

1. Get your Shopify credentials:

   • Log in to your Shopify admin panel
   • Go to Settings → Apps and sales channels → Develop apps
   • Create a new app or use an existing one
   • Configure API scopes (read/write access as needed)
   • Install the app and copy the Admin API access token

2. Configure Claude Desktop:

   Edit your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

   Add the Shopify server configuration:

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

3. Restart Claude Desktop to apply the changes

Features

Available Tools

• Products: List, get, create, and update products
• Orders: List and retrieve order details
• Customers: List and retrieve customer information
• Inventory: Check levels and adjust quantities
• Collections: Browse product collections
• Locations: List store locations
• Metafields: Set custom data on resources
• Shop Info: Get store analytics and information

Example Commands

Ask Claude to:

• "Show me my top 10 products"
• "List recent orders"
• "Find customers who spent over $500"
• "Check which products are low on stock"
• "Update the price of product XYZ"
• "Create a new product with variants"

API Scopes Required

The following Shopify API scopes are recommended:

• read_products / write_products
• read_orders
• read_customers
• read_inventory / write_inventory
• read_locations

Grant only the scopes you need for better security.

Local Development

If you want to run from source:

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

Then update your Claude config to use the local build:

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

Troubleshooting

If the server doesn't appear in Claude:

1. Check that your credentials are correct
2. Ensure Claude Desktop is fully restarted
3. Look for errors in the MCP logs
4. Try running the server manually to test:

   SHOPIFY_STORE_DOMAIN=your-store.myshopify.com \
   SHOPIFY_ACCESS_TOKEN=shpat_your_token \
   npx @ajackus/shopify-mcp-server
   

Security

• Never share or commit your access tokens
• Use environment variables for credentials
• Create separate apps with minimal scopes for different use cases
• Regularly rotate your access tokens

License

MIT

Contributing

Issues and pull requests are welcome at: https://github.com/ajackus/shopify-mcp-server