GeLi2001/shopify-mcp

(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**: Full CRUD for products, variants, and options (8 tools)
- **Customer Management**: Full CRUD, merge, and address management (8 tools)
- **Order Management**: Smart lookup, cancel, close/open, mark as paid, fulfillment, refunds (10 tools)
- **Metafield Management**: Get, set, and delete metafields on any resource (3 tools)
- **Inventory Management**: Set absolute inventory quantities at locations (1 tool)
- **Tag Management**: Add/remove tags on any taggable resource (1 tool)
- **Pagination & Sorting**: Cursor-based pagination and sort keys on all list queries
- **Advanced Filtering**: Pass-through Shopify query syntax for all list endpoints
- **GraphQL Integration**: Direct integration with Shopify's GraphQL Admin API (2026-01)
- **Comprehensive Error Handling**: Clear error messages for API and authentication issues
Prerequisites
1. Node.js (version 18 or higher)
2. A Shopify store with a custom app (see setup instructions below)
Setup
Authentication
This server supports two authentication methods:
Option 1: Client Credentials (Dev Dashboard apps, January 2026+)
As of January 1, 2026, new Shopify apps are created in the **Dev Dashboard** and use OAuth client credentials instead of static access tokens.
1. From your Shopify admin, go to **Settings** > **Apps and sales channels**
2. Click **Develop apps** > **Build app in dev dashboard**
3. Create a new app and configure **Admin API scopes**:
- read_products, write_products
- read_customers, write_customers
- read_orders, write_orders
4. Install the app on your store
5. Copy your **Client ID** and **Client Secret** from the app's API credentials
The server will automatically exchange these for an access token and refresh it before it expires (tokens are valid for ~24 hours).
Option 2: Static Access Token (legacy apps)
If you have an existing custom app with a static shpat_ access token, you can still use it directly.
Usage with Claude Desktop
**Client Credentials (recommended):**
**Static Access Token (legacy):**
Locations for the Claude Desktop config file:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
Usage with Claude Code
**Client Credentials:**
**Static Access Token (legacy):**
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:
**Client Credentials:**
**Static Access Token (legacy):**
2. Run the server with npx:
Direct Installation (Optional)
If you want to install the package globally:
Then run it:
Additional Options
- --apiVersion: Specify the Shopify API version (default: 2026-01). Can also be set via SHOPIFY_API_VERSION environment variable.
**⚠️ 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 (31)
Pagination, Sorting & Filtering
All list query tools (get-products, get-customers, get-orders, get-customer-orders) support:
- **Cursor-based pagination**: after / before (cursor strings), with pageInfo in the response (hasNextPage, hasPreviousPage, startCursor, endCursor)
- **Sorting**: sortKey (enum specific to each resource) and reverse (boolean)
- **Advanced filtering**: query or searchQuery parameter accepting Shopify query syntax
Product Management (8 tools)
1. **get-products**
- Get all products or search by title with pagination and sorting
- Inputs:
- searchTitle (string, optional): Filter products by title (wraps in title:*...*)
- limit (number, default: 10): Maximum number of products to return
- query (string, optional): Raw Shopify query string (e.g. "status:active vendor:Nike tag:sale")
- sortKey (string, optional): One of CREATED_AT, ID, INVENTORY_TOTAL, PRODUCT_TYPE, PUBLISHED_AT, RELEVANCE, TITLE, UPDATED_AT, VENDOR
- reverse (boolean, optional): Reverse the sort order