Shopify MCP Server

Interact with Shopify store data such as products, customers, and orders using the GraphQL API.

MCP Server for Shopify API, enabling interaction with store data (products, customers, orders, etc.) via GraphQL.

Provides tools for product, customer, and order management, direct GraphQL integration, and clear error handling.
- Node.js (v16+)
- Shopify Custom App Access Token

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

- Create Custom App: In Shopify admin >Settings>Apps and sales channels>Develop apps>Create an app.
- Configure Scopes: Grantread/writepermissions forproducts,customers, andorders.
- Install App & Get Token: Install the app and copy theAdmin API access token.
- Create.envfilein the project root:

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

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%/Claude/claude_desktop_config.json

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

- findProducts: Get all products or search by title.

- searchTitle(optional string): Filter by title.
- limit(number): Max products.

- collectionId(string): Collection ID.
- limit(optional number, default: 10): Max products.

- productIds(array of strings): Product IDs.

- variantIds(array of strings): Variant IDs.
- listCustomers: Get customers with pagination.

- limit(optional number): Max customers.
- next(optional string): Next page cursor.

- customerId(string): Customer ID.
- tags(array of strings): Tags to add.
- findOrders: Get orders with advanced filtering/sorting.

- first(optional number): Limit orders.
- after(optional string): Next page cursor.
- query(optional string): Filter query.
- sortKey(optional enum): Sort field.
- reverse(optional boolean): Reverse sort.

- lineItems(array): Items (variantId, quantity).
- email(string): Customer email.
- shippingAddress(object): Shipping details.
- note(optional string): Order note.

- draftOrderId(string): Draft order ID.
- variantId(string): Variant ID.
- createDiscountCode: Create a basic discount code.

- title(string): Discount title.
- code(string): Discount code.
- valueType(enum): 'percentage' or 'fixed_amount'.
- value(number): Discount value.
- startsAt(string): Start date (ISO).
- endsAt(optional string): End date (ISO).
- appliesOncePerCustomer(boolean): Limit one use per customer.
- listCollections: Get all collections.

- limit(optional number, default: 10): Max collections.
- name(optional string): Filter by name.
- getShopDetails: Get basic shop details (No inputs).
- getExtendedShopDetails: Get extended shop details (No inputs).
- debugGetVariantMetafield: Get variant &size_chart_jsonmetafield.

- variantId(string): Variant GID.
- introspect_admin_schema: Introspect Admin API GraphQL schema.

- query(string): Filter term.
- filter(optional array): Filter by 'types', 'queries', 'mutations', 'all'.

Check Claude Desktop MCP logs:tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

- Authentication: Check token, domain format, API scopes.
- API Errors: Check rate limits, input formats, required fields.

- @modelcontextprotocol/sdk
- graphql-request
- zod

Note: Fork oforiginal shopify-mcp-server repository

Access eBay Analytics data via the CData JDBC Driver.