Connects to live Shopify stores via Admin and Storefront APIs for real operations
Shopify Store MCP Server
A Model Context Protocol (MCP) server that connects to live Shopify stores via the Admin and Storefront APIs. Unlike documentation-only MCPs, this server enables AI agents to perform real operations on your store.
Why This MCP?
| Feature | Shopify Store MCP | Shopify Dev MCP |
|---|---|---|
| Execute GraphQL queries | ✅ Real API calls | ❌ Documentation only |
| Modify store data | ✅ Full CRUD | ❌ No |
| Upload files | ✅ Yes | ❌ No |
| Bulk operations | ✅ Yes | ❌ No |
| API documentation | ❌ No | ✅ Yes |
| Schema introspection | ❌ No | ✅ Yes |
Important: For the best experience, use both this MCP and the official Shopify Dev MCP together. The Dev MCP helps your AI agent understand Shopify's API schemas and documentation, while this MCP executes the actual operations on your store.
Features
- Universal GraphQL Access — Execute any Admin API query or mutation via
run_graphql_query - Smart Multi-Step Tools — File uploads, bulk operations, metaobject upserts with automatic polling
- Rate Limiting — Respects Shopify's plan-based rate limits (Standard/Advanced/Plus/Enterprise)
- Operation Logging — SQLite database tracks all operations for debugging and history
- Schema Discovery — Explore your store's metafield definitions and metaobject types
Prerequisites
- Node.js 18+
- Shopify store with a custom app
- Admin API access token — Create a custom app in Shopify Admin → Settings → Apps and development channels → Develop apps
Installation
Cursor
Quick Install
After installing, edit the configuration to add your actual store credentials.
Manual Configuration
Add to your Cursor MCP settings (~/.cursor/mcp.json):
{
"mcpServers": {
"shopify-store-mcp": {
"command": "npx",
"args": ["-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Windows Configuration
{
"mcpServers": {
"shopify-store-mcp": {
"command": "cmd",
"args": ["/k", "npx", "-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Claude Desktop
Add to your Claude Desktop config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"shopify-store-mcp": {
"command": "npx",
"args": ["-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Windows Configuration
{
"mcpServers": {
"shopify-store-mcp": {
"command": "cmd",
"args": ["/k", "npx", "-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Claude Code (CLI)
Add to your Claude Code settings (~/.claude/settings.json):
{
"mcpServers": {
"shopify-store-mcp": {
"command": "npx",
"args": ["-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
<
Tools (1)
run_graphql_queryExecutes any Admin API query or mutation against the connected Shopify store.Environment Variables
SHOPIFY_STORE_URLrequiredThe URL of your Shopify store (e.g., your-store.myshopify.com)SHOPIFY_ACCESS_TOKENrequiredAdmin API access token from your Shopify custom appConfiguration
{"mcpServers": {"shopify-store-mcp": {"command": "npx", "args": ["-y", "shopify-store-mcp"], "env": {"SHOPIFY_STORE_URL": "your-store.myshopify.com", "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"}}}}