Shopify

by amir-bengherbi

Recommended
6 stars
2k downloads
Not rated
GitHub

About

Integrates with Shopify's GraphQL API to enable comprehensive store management, including product, customer, order, and discount operations.

Details

Author
amir-bengherbi
Repository
amir-bengherbi/shopify-mcp-server
GitHub stars
6
Downloads
1,988
License
MIT License
Categories
Cloud Service, Other, Automation, AI, Design, Developer Tools, Search, API, Frontend
Tags
#web, #visualization

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

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Shopify
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 shopify-mcp-server
    Environment
    • MYSHOPIFY_DOMAIN <YOUR_SHOP>.myshopify.com
    • SHOPIFY_ACCESS_TOKEN <YOUR_ACCESS_TOKEN>

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

get-products

Get all products or search by title. Inputs: searchTitle (optional string), limit (number). Returns: Formatted product details including title, description, handle, and variants.

get-products-by-collection

Get products from a specific collection. Inputs: collectionId (string), limit (optional number, default: 10). Returns: Formatted product details from the specified collection.

get-products-by-ids

Get products by their IDs. Inputs: productIds (array of strings). Returns: Formatted product details for the specified products.

get-variants-by-ids

Get product variants by their IDs. Inputs: variantIds (array of strings). Returns: Detailed variant information including product details.

get-customers

Get Shopify customers with pagination support. Inputs: limit (optional number), next (optional string). Returns: Customer data in JSON format.

tag-customer

Add tags to a customer. Inputs: customerId (string), tags (array of strings). Returns: Success or failure message.

get-orders

Get orders with advanced filtering and sorting. Inputs: first (optional number), after (optional string), query (optional string), sortKey (optional enum), reverse (optional boolean). Returns: Formatted order details.

get-order

Get a single order by ID. Inputs: orderId (string). Returns: Detailed order information.

create-discount

Create a basic discount code. Inputs: title (string), code (string), valueType (enum), value (number), startsAt (string), endsAt (optional string), appliesOncePerCustomer (boolean). Returns: Created discount details.

create-draft-order

Create a draft order. Inputs: lineItems (array), email (string), shippingAddress (object), note (optional string). Returns: Created draft order details.

complete-draft-order

Complete a draft order. Inputs: draftOrderId (string), variantId (string). Returns: Completed order details.

get-collections

Get all collections. Inputs: limit (optional number, default: 10), name (optional string). Returns: Collection details.

get-shop

Get shop details. Inputs: None. Returns: Basic shop information.

get-shop-details

Get extended shop details including shipping countries. Inputs: None. Returns: Extended shop information including shipping countries.

manage-webhook

Subscribe, find, or unsubscribe webhooks. Inputs: action (enum), callbackUrl (string), topic (enum), webhookId (optional string). Returns: Webhook details or success message.

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
Returns: Formatted product details including title, description, handle, and variants

2. get-products-by-collection
Get products from a specific collection
Inputs:
collectionId (string): ID of the collection to get products from
limit (optional number, default: 10): Maximum number of products to return
Returns: Formatted product details from the specified collection

3. get-products-by-ids
Get products by their IDs
Inputs:
productIds (array of strings): Array of product IDs to retrieve
Returns: Formatted product details for the specified products

4. get-variants-by-ids
Get product variants by their IDs
Inputs:
variantIds (array of strings): Array of variant IDs to retrieve
Returns: Detailed variant information including product details

5. get-customers
Get shopify customers with pagination support
Inputs:
limit (optional number): Maximum number of customers to return
next (optional string): Next page cursor
Returns: Customer data in JSON format

6. tag-customer
Add tags to a customer
Inputs:
customerId (string): Customer ID to tag
tags (array of strings): Tags to add to the customer
Returns: Success or failure message

7. get-orders
Get orders with advanced filtering and sorting
Inputs:
first (optional number): Limit of orders to return
after (optional string): Next page cursor
query (optional string): Filter orders using query syntax
sortKey (optional enum): Field to sort by ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
reverse (optional boolean): Reverse sort order
Returns: Formatted order details

8. get-order
Get a single order by ID
Inputs:
orderId (string): ID of the order to retrieve
Returns: Detailed order information

9. create-discount
Create a basic discount code
Inputs:
title (string): Title of the discount
code (string): Discount code that customers will enter
valueType (enum): Type of discount ('percentage' or 'fixed_amount')
value (number): Discount value (percentage as decimal or fixed amount)
startsAt (string): Start date in ISO format
endsAt (optional string): Optional end date in ISO format
appliesOncePerCustomer (boolean): Whether discount can be used only once per customer
Returns: Created discount details

10. create-draft-order
Create a draft order
Inputs:
lineItems (array): Array of items with variantId and quantity
email (string): Customer email
shippingAddress (object): Shipping address details
note (optional string): Optional note for the order
Returns: Created draft order details

11. complete-draft-order
Complete a draft order
Inputs:
draftOrderId (string): ID of the draft order to complete
variantId (string): ID of the variant in the draft order
Returns: Completed order details

12. get-collections
Get all collections
Inputs:
limit (optional number, default: 10): Maximum number of collections to return
name (optional string): Filter collections by name
Returns: Collection details

13. get-shop
Get shop details
Inputs: None
Returns: Basic shop information

14. get-shop-details
Get extended shop details including shipping countries
Inputs: None
Returns: Extended shop information including shipping countries

15. manage-webhook
Subscribe, find, or unsubscribe webhooks
Inputs:
action (enum): Action to perform ('subscribe', 'find', 'unsubscribe')
callbackUrl (string): Webhook callback URL
topic (enum): Webhook topic to subscribe to
webhookId (optional string): Webhook ID (required for unsubscribe)
Returns: Webhook details or success message

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "shopify": {
            "env": {
                "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com",
                "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
            },
            "args": [
                "-y",
                "shopify-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
    },
    "args": [
        "-y",
        "shopify-mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
    },
    "args": [
        "-y",
        "shopify-mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "MYSHOPIFY_DOMAIN": "<YOUR_SHOP>.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "shopify-mcp-server"
    ],
    "command": "cmd"
}

Shopify MCP Server

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

<a href="https://glama.ai/mcp/servers/bemvhpy885">Shopify Server MCP server</a>

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

Tools

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
Returns: Formatted product details including title, description, handle, and variants

2. get-products-by-collection
Get products from a specific collection
Inputs:
collectionId (string): ID of the collection to get products from
limit (optional number, default: 10): Maximum number of products to return
Returns: Formatted product details from the specified collection

3. get-products-by-ids
Get products by their IDs
Inputs:
productIds (array of strings): Array of product IDs to retrieve
Returns: Formatted product details for the specified products

4. get-variants-by-ids
Get product variants by their IDs
Inputs:
variantIds (array of strings): Array of variant IDs to retrieve
Returns: Detailed variant information including product details

5. get-customers
Get shopify customers with pagination support
Inputs:
limit (optional number): Maximum number of customers to return
next (optional string): Next page cursor
Returns: Customer data in JSON format

6. tag-customer
Add tags to a customer
Inputs:
customerId (string): Customer ID to tag
tags (array of strings): Tags to add to the customer
Returns: Success or failure message

7. get-orders
Get orders with advanced filtering and sorting
Inputs:
first (optional number): Limit of orders to return
after (optional string): Next page cursor
query (optional string): Filter orders using query syntax
sortKey (optional enum): Field to sort by ('PROCESSED_AT', 'TOTAL_PRICE', 'ID', 'CREATED_AT', 'UPDATED_AT', 'ORDER_NUMBER')
reverse (optional boolean): Reverse sort order
Returns: Formatted order details

8. get-order
Get a single order by ID
Inputs:
orderId (string): ID of the order to retrieve
Returns: Detailed order information

9. create-discount
Create a basic discount code
Inputs:
title (string): Title of the discount
code (string): Discount code that customers will enter
valueType (enum): Type of discount ('percentage' or 'fixed_amount')
value (number): Discount value (percentage as decimal or fixed amount)
startsAt (string): Start date in ISO format
endsAt (optional string): Optional end date in ISO format
appliesOncePerCustomer (boolean): Whether discount can be used only once per customer
Returns: Created discount details

10. create-draft-order
Create a draft order
Inputs:
lineItems (array): Array of items with variantId and quantity
email (string): Customer email
shippingAddress (object): Shipping address details
note (optional string): Optional note for the order
Returns: Created draft order details

11. complete-draft-order
Complete a draft order
Inputs:
draftOrderId (string): ID of the draft order to complete
variantId (string): ID of the variant in the draft order
Returns: Completed order details

12. get-collections
Get all collections
Inputs:
limit (optional number, default: 10): Maximum number of collections to return
name (optional string): Filter collections by name
Returns: Collection details

13. get-shop
Get shop details
Inputs: None
Returns: Basic shop information

14. get-shop-details
Get extended shop details including shipping countries
Inputs: None
Returns: Extended shop information including shipping countries

15. manage-webhook
Subscribe, find, or unsubscribe webhooks
Inputs:
action (enum): Action to perform ('subscribe', 'find', 'unsubscribe')
callbackUrl (string): Webhook callback URL
topic (enum): Webhook topic to subscribe to
webhookId (optional string): Webhook ID (required for unsubscribe)
Returns: Webhook details or success message

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.