Shopify Storefront

Shopify Storefront

Unofficial MCP server enabling AI agents to access Shopify Storefront data via MCP.

5
Stars
5
Forks
0
Releases

Overview

This MCP server exposes the Shopify Storefront API to MCP-powered AI assistants, enabling them to discover Shopify storefronts and interact with store data through a unified interface. It provides access to product listings, collections, and inventory, and supports cart creation and management. The server accepts GraphQL queries and mutations against the Storefront API, with automatic token handling and validation to ease authentication. It includes MCP tools such as shopify_discover (detects whether a URL is a Shopify storefront and reveals authentication tokens), shopify_storefront_graphql (executes GraphQL queries), and customer_data (a unified interface for create, read, update, and delete operations on customer information). Customer data can be stored locally in user_data/customer.json, with an example template provided as customer.json.example; data persists across restarts. The README also demonstrates workflows for creating checkouts using customer data and GraphQL mutations. Environment configuration is via a .env file (required token and store name, optional API version and buyer IP). Security considerations include not committing secrets and using environment variables, along with guidance on token generation and troubleshooting.

Details

Owner
QuentinCody
Language
Python
License
Updated
2025-12-07

Features

Access to product, collection, and inventory data

Expose product listings, collections, and inventory data through the MCP interface.

Cart creation and management

Create and manage shopping carts via MCP-enabled interactions with the Storefront API.

Support for GraphQL queries and mutations

Run GraphQL queries and mutations against the Shopify Storefront API.

Automatic token handling and validation

Automatically manage and validate Storefront API tokens to streamline authentication.

Easy integration with MCP-compatible AI assistants

Designed for straightforward use with MCP-enabled AI agents.

Shopify storefront discovery tool (shopify_discover)

Detect Shopify storefront URLs and discover authentication tokens.

Storefront GraphQL tool (shopify_storefront_graphql)

Execute GraphQL queries against the Storefront API via MCP.

Customer data tool (customer_data)

Unified interface to create, read, update, and delete customer information.

Audience

AI developersIntegrate MCP-compatible AI assistants to discover Shopify storefronts and query/storefront data (products, collections, cart, customer data) via MCP.

Tags

ShopifyStorefront APIMCPGraphQLAI assistantsCart managementCustomer dataToken handling