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 .env file 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

Shopify Store MCP Server