Connects to live Shopify stores via Admin and Storefront APIs, enabling operations such as executing GraphQL queries, performing bulk exports/imports, uploading files, managing metaobjects, and discovering store schemas.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shopify Store MCP Serversummarize my store's orders from the last 7 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_querySmart 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
Or run directly with npx:
Usage with Claude Desktop or Cursor
Add the following to your MCP configuration:
On Windows, use this configuration:
Environment Variables
Variable | Required | Default | Description |
| Yes | - | Store's myshopify.com domain |
| Yes | - | Admin API access token |
| No | - | Storefront API token |
| No |
| API version |
| No |
| Rate limit tier |
Available Tools
Core Tools
Tool | Description |
| Retrieve store configuration and settings |
| Execute any GraphQL query or mutation |
Smart Tools
Tool | Description |
| Upload file from URL, poll until ready, return CDN URL |
| Start bulk query, poll completion, return JSONL download URL |
| Staged upload + bulk mutation with automatic polling |
| Create or update metaobject by handle (idempotent) |
| Discover metafield definitions and metaobject types |
Infrastructure Tools
Tool | Description |
| Set rate limit tier (manual or auto-detect from shop plan) |
| Query past operations for debugging |
| 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 |
| Product analysis template |
| Order summary by timeframe |
| Inventory health check |
| Customer segment analysis |
| Help building custom GraphQL queries |
Available Resources
Resource | Description |
| Current store connection info |
| Query syntax reference |
| GID format reference |
| API scopes reference |
Development
Database
The server uses SQLite for operation logging and configuration. The database is automatically created at ~/.shopify-mcp/mcp.db.
Security
Never commit your
.envfile or access tokensUse 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