Shopify Storefront MCP Server

Name: Shopify Storefront MCP Server
Author: QuentinCody

@QuentinCody

Repository

About Shopify Storefront MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Shopify Storefront MCP Server": {
      "command": "python",
      "args": [
        "-m",
        "shopify_storefront_mcp_server"
      ],
      "env": {
        "SHOPIFY_STOREFRONT_ACCESS_TOKEN": "",
        "SHOPIFY_STORE_NAME": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Shopify Storefront MCP Server?

The Shopify Storefront MCP Server provides access to the Shopify Storefront API via MCP, allowing AI assistants to query and interact with your Shopify store data.

How to use Shopify Storefront MCP Server?

Configure your Shopify store name and Storefront API token in a .env file, then run python -m shopify_storefront_mcp_server. The server exposes MCP tools: shopify_discover, shopify_storefront_graphql, and customer_data.

Key features of Shopify Storefront MCP Server

Access product, collection, and inventory data
Cart creation and management
Support for GraphQL queries and mutations
Automatic token handling and validation
Easy integration with MCP-compatible AI assistants
Customer data management with unified tool

Use cases of Shopify Storefront MCP Server

Query product listings, collections, and inventory levels
Create and manage shopping carts with GraphQL
Store and retrieve customer profile information
Personalize checkout by attaching customer data to carts
Execute arbitrary Storefront GraphQL mutations

FAQ from Shopify Storefront MCP Server

How do I authenticate with the Shopify Storefront API?

Set SHOPIFY_STOREFRONT_ACCESS_TOKEN and SHOPIFY_STORE_NAME in your .env file. The token is generated from the Shopify Admin > Apps > Develop apps.

What scopes are needed for the Storefront API token?

Required scopes include unauthenticated_read_product_listings, unauthenticated_read_product_inventory, unauthenticated_read_product_pricing, unauthenticated_write_checkouts, and unauthenticated_read_content.

Where is customer data stored?

Customer data is stored locally in user_data/customer.json. This file persists between server restarts and should not be committed to version control.

What are the required environment variables?

The required variables are SHOPIFY_STOREFRONT_ACCESS_TOKEN and SHOPIFY_STORE_NAME. Optionally set SHOPIFY_API_VERSION (default 2025-04) and SHOPIFY_BUYER_IP.

How can I test my token directly?

Use curl -X POST https://your-store.myshopify.com/api/2025-04/graphql.json -H "Content-Type: application/json" -H "X-Shopify-Storefront-Access-Token: your_token" -d '{"query": "query { shop { name } }"}'