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.
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
Setup
Prerequisites
- A Shopify store with a custom app
- Admin API access token with required scopes
- Node.js 18+
Installation
npm install -g shopify-store-mcp
Or run directly with npx:
npx shopify-store-mcp
Usage with Claude Desktop or Cursor
Add the following to your MCP configuration:
{
"mcpServers": {
"shopify-store": {
"command": "npx",
"args": ["-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
On Windows, use this configuration:
{
"mcpServers": {
"shopify-store": {
"command": "cmd",
"args": ["/k", "npx", "-y", "shopify-store-mcp"],
"env": {
"SHOPIFY_STORE_URL": "your-store.myshopify.com",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
SHOPIFY_STORE_URL | Yes | - | Store's myshopify.com domain |
SHOPIFY_ACCESS_TOKEN | Yes | - | Admin API access token |
SHOPIFY_STOREFRONT_ACCESS_TOKEN | No | - | Storefront API token |
SHOPIFY_API_VERSION | No | 2025-01 | API version |
SHOPIFY_TIER | No | STANDARD | Rate limit tier |
Available Tools
Core Tools
| Tool | Description |
|---|---|
get_shop_info | Retrieve store configuration and settings |
run_graphql_query | Execute any GraphQL query or mutation |
Smart Tools
| Tool | Description |
|---|---|
upload_file | Upload file from URL, poll until ready, return CDN URL |
bulk_export | Start bulk query, poll completion, return JSONL download URL |
bulk_import | Staged upload + bulk mutation with automatic polling |
upsert_metaobject | Create or update metaobject by handle (idempotent) |
schema_discover | Discover metafield definitions and metaobject types |
Infrastructure Tools
| Tool | Description |
|---|---|
configure | Set rate limit tier (manual or auto-detect from shop plan) |
get_history | Query past operations for debugging |
get_stats | Aggregated usage statistics |
Rate Limiting
The server respects Shopify's rate limits based on your shop plan:
| Tier | Requests/sec | Plans |
|---|---|---|
| STANDARD | 1 | Basic, Development, Lite |
| ADVANCED | 2 | Advanced |
| PLUS | 5 | Shopify Plus |
| ENTERPRISE | 10 | Commerce Components |
Use the configure tool to set your tier manually or auto-detect from your shop plan.
Available Prompts
| Prompt | Description |
|---|---|
analyze-product | Product analysis template |
summarize-orders | Order summary by timeframe |
inventory-health | Inventory health check |
customer-insights | Customer segment analysis |
custom-query | Help building custom GraphQL queries |
Available Resources
| Resource | Description |
|---|---|
shopify://config | Current store connection info |
shopify://docs/query-syntax | Query syntax reference |
shopify://docs/gid-format | GID format reference |
shopify://docs/scopes | API scopes reference |
Development
# Install dependencies
npm install
# Build
npm run build
# Run with inspector
npm run inspect
# Watch mode
npm run dev
Database
The server uses SQLite for operation logging and configuration. The database is automatically created at ~/.shopify-mcp/mcp.db.
# View database
npm run db:studio
Security
- Never commit your
.envfile or access tokens - Use environment variables or MCP config for credentials
- Access tokens should have minimal required scopes
- The server logs operations locally for debugging (disable with
MCP_LOG_OPERATIONS=false)
License
ISC