Shopify Storefront

This MCP server exposes the Shopify Storefront API to your AI assistants, enabling seamless querying of products, collections, carts, and customer data. By running the server locally or remotely, you can empower automation and chat-based workflows to inspect store data, create checkouts, and personalize interactions with stored customer information.

How to use

Use an MCP client to connect to the Shopify Storefront MCP Server and perform GraphQL queries or mutations against your store. You can discover eligible storefront URLs, execute GraphQL operations, and manage customer data through unified tools. This enables you to fetch product listings, read inventory, create and manage carts, and attach customer attributes to checkouts for streamlined purchasing flows.

How to install

Prerequisites: ensure you have Python and a modern runtime environment available on your system.

1. Clone the project repository to your development machine.

2. Install the required Python dependencies.

pip install -r requirements.txt

3. Create a local environment file from the template and fill in your store details.

# Copy the example template to a real environment file
cp .env.example .env
# Open .env and set required values
# SHOPIFY_STOREFRONT_ACCESS_TOKEN=your_storefront_token
# SHOPIFY_STORE_NAME=your-store-name

4. Generate a Storefront API token from your Shopify admin with the necessary permissions, then add it to your environment file as SHOPIFY_STOREFRONT_ACCESS_TOKEN.

5. Run the server using Python.

python -m shopify_storefront_mcp_server

Additional configuration and usage notes

Environment variables shown in the example template include the required access token and store name, with optional settings for API version and buyer IP. These variables control authentication, store targeting, and optional API behavior.

The server provides tools to discover Shopify storefronts, execute GraphQL operations, and manage customer data. Access patterns typically involve discovering a storefront URL, running GraphQL queries or mutations against the Storefront API, and optionally associating stored customer attributes with carts or checkouts.

Data privacy & storage

Customer data is stored in a dedicated JSON file and should be excluded from version control. The system supports persisting customer profiles and custom fields for personalization, and provides a unified interface to manage all customer data.

When bootstrapping data for the first time, you can copy a template file to initialize storage. All personal information should be treated with care and security.

Creating Checkouts with Customer Data

You can combine stored customer data with GraphQL mutations to create checkouts that prefill customer attributes. This enables a smoother checkout experience by providing email and delivery/address data as part of the cart creation flow.

Security considerations

Keep the Storefront API token secret and do not commit your environment files to version control. Use environment variables for sensitive information and consider IP restrictions in your Shopify Admin to reduce exposure.

Available tools

shopify_discover

Detect if a URL belongs to a Shopify storefront and discover authentication tokens

shopify_storefront_graphql

Execute GraphQL queries against the Storefront API

customer_data

Unified tool for all customer data operations (CRUD and custom fields)