Shopify

What is Shopify MCP Server?

Shopify MCP Server is a server-side application that facilitates interaction with the Shopify API, specifically designed for use with MCP (Multi-Cloud Platform) hosts like Claude and Cursor. It allows users to manage various aspects of their Shopify store data, including products, customers, and orders, through a GraphQL API.

How to use Shopify MCP Server?

To use the Shopify MCP Server, you need Node.js (version 16 or higher) and a Shopify Custom App Access Token. The setup involves creating a custom app in your Shopify store, configuring Admin API scopes (read/write for products, customers, and orders), and obtaining an Admin API access token. You can then integrate it with Claude Desktop by adding configuration to claude_desktop_config.json or run it locally using environment variables (SHOPIFY_ACCESS_TOKEN, MYSHOPIFY_DOMAIN) or direct global installation via npm.

Key Features of Shopify MCP Server

• Product Management: Search, retrieve, and manage product information.
• Customer Management: Load customer data, manage customer tags, and update customer information.
• Order Management: Advanced querying, filtering, and updating of orders.
• GraphQL Integration: Direct integration with Shopify's GraphQL Admin API for efficient data interaction.
• Comprehensive Error Handling: Provides clear error messages for API and authentication issues.
• Available Tools: Includes specific tools for product management (get-products, get-product-by-id), customer management (get-customers, update-customer, get-customer-orders), and order management (get-orders, get-order-by-id, update-order).

Use Cases of Shopify MCP Server

This server is ideal for developers and businesses looking to automate and streamline their Shopify store management. Specific use cases include:

• Automating Product Updates: Programmatically update product details, inventory, and pricing.
• Customer Relationship Management: Integrate Shopify customer data with external CRM systems or automate customer tag management.
• Order Fulfillment and Tracking: Develop custom solutions for managing and tracking orders, including updating order status and details.
• Custom Reporting: Extract specific data for custom reports and analytics beyond Shopify's built-in capabilities.
• Building Custom Applications: Serve as a backend for custom applications that require direct interaction with Shopify data.

FAQ from Shopify MCP Server

Q: What are the prerequisites for using Shopify MCP Server? A: You need Node.js (version 16 or higher) and a Shopify Custom App Access Token.

Q: How do I get a Shopify Access Token? A: You need to create a custom app in your Shopify store, configure the necessary Admin API scopes, and then install the app to get your Admin API access token.

Q: What if I see errors about "SHOPIFY_ACCESS_TOKEN environment variable is required"? A: This might happen if you have a different package installed. Ensure you are using shopify-mcp and not shopify-mcp-server.

Q: How can I debug issues with Shopify MCP Server? A: You can check Claude Desktop's MCP logs, typically located at ~/Library/Logs/Claude/mcp*.log on MacOS or %APPDATA%/Claude/mcp*.log on Windows.

Shopify MCP Server

(please leave a star if you like!)

MCP Server for Shopify API, enabling interaction with store data through GraphQL API. This server provides tools for managing products, customers, orders, and more.

📦 Package Name: shopify-mcp
🚀 Command: shopify-mcp (NOT shopify-mcp-server)

Features

• Product Management: Search and retrieve product information
• Customer Management: Load customer data and manage customer tags
• Order Management: Advanced order querying and filtering
• GraphQL Integration: Direct integration with Shopify's GraphQL Admin API
• Comprehensive Error Handling: Clear error messages for API and authentication issues

Prerequisites

1. Node.js (version 16 or higher)
2. Shopify Custom App Access Token (see setup instructions below)

Setup

Shopify Access Token

To use this MCP server, you'll need to create a custom app in your Shopify store:

1. From your Shopify admin, go to Settings > Apps and sales channels
2. Click Develop apps (you may need to enable developer preview first)
3. Click Create an app
4. Set a name for your app (e.g., "Shopify MCP Server")
5. Click Configure Admin API scopes
6. Select the following scopes:
   • read_products, write_products
   • read_customers, write_customers
   • read_orders, write_orders
7. Click Save
8. Click Install app
9. Click Install to give the app access to your store data
10. After installation, you'll see your Admin API access token
11. Copy this token - you'll need it for configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--accessToken",
        "<YOUR_ACCESS_TOKEN>",
        "--domain",
        "<YOUR_SHOP>.myshopify.com"
      ]
    }
  }
}

Locations for the Claude Desktop config file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Alternative: Run Locally with Environment Variables

If you prefer to use environment variables instead of command-line arguments:

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

   SHOPIFY_ACCESS_TOKEN=your_access_token
   MYSHOPIFY_DOMAIN=your-store.myshopify.com
   

2. Run the server with npx:

   npx shopify-mcp
   

Direct Installation (Optional)

If you want to install the package globally:

npm install -g shopify-mcp

Then run it:

shopify-mcp --accessToken=<YOUR_ACCESS_TOKEN> --domain=<YOUR_SHOP>.myshopify.com

⚠️ Important: If you see errors about "SHOPIFY_ACCESS_TOKEN environment variable is required" when using command-line arguments, you might have a different package installed. Make sure you're using shopify-mcp, not shopify-mcp-server.

Available Tools

Product Management

1. get-products

   • Get all products or search by title
   • Inputs:
     • searchTitle (optional string): Filter products by title
     • limit (number): Maximum number of products to return

2. get-product-by-id

   • Get a specific product by ID
   • Inputs:
     • productId (string): ID of the product to retrieve

Customer Management

1. get-customers

   • Get customers or search by name/email
   • Inputs:
     • searchQuery (optional string): Filter customers by name or email
     • limit (optional number, default: 10): Maximum number of customers to return

2. update-customer

   • Update a customer's information
   • Inputs:
     • id (string, required): Shopify customer ID (numeric ID only, like "6276879810626")
     • firstName (string, optional): Customer's first name
     • lastName (string, optional): Customer's last name
     • email (string, optional): Customer's email address
     • phone (string, optional): Customer's phone number
     • tags (array of strings, optional): Tags to apply to the customer
     • note (string, optional): Note about the customer
     • taxExempt (boolean, optional): Whether the customer is exempt from taxes
     • metafields (array of objects, optional): Customer metafields for storing additional data

3. get-customer-orders

   • Get orders for a specific customer
   • Inputs:
     • customerId (string, required): Shopify customer ID (numeric ID only, like "6276879810626")
     • limit (optional number, default: 10): Maximum number of orders to return

Order Management

1. get-orders

   • Get orders with optional filtering
   • Inputs:
     • status (optional string): Filter by order status
     • limit (optional number, default: 10): Maximum number of orders to return

2. get-order-by-id

   • Get a specific order by ID
   • Inputs:
     • orderId (string, required): Full Shopify order ID (e.g., "gid://shopify/Order/6090960994370")

3. update-order

   • Update an existing order with new information
   • Inputs:
     • id (string, required): Shopify order ID
     • tags (array of strings, optional): New tags for the order
     • email (string, optional): Update customer email
     • note (string, optional): Order notes
     • customAttributes (array of objects, optional): Custom attributes for the order
     • metafields (array of objects, optional): Order metafields
     • shippingAddress (object, optional): Shipping address information

Debugging

If you encounter issues, check Claude Desktop's MCP logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

License

MIT