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 } }"}'
