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"
      }
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings (settings.json):

{
  "mcp.servers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config (~/.windsurf/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"
      }
    }
  }
}

Other MCP Clients

For any MCP-compatible client, use:

npx -y shopify-store-mcp

With environment variables:

SHOPIFY_STORE_URL — Your store's myshopify.com domain
SHOPIFY_ACCESS_TOKEN — Admin API access token

Recommended: Add Shopify Dev MCP

For the best AI agent experience, also add the official Shopify Dev MCP. It provides:

API documentation search
GraphQL schema introspection
Query validation
Up-to-date Shopify API knowledge

This helps your AI agent know what queries to write before executing them with this MCP.

{
  "mcpServers": {
    "shopify-store-mcp": {
      "command": "npx",
      "args": ["-y", "shopify-store-mcp"],
      "env": {
        "SHOPIFY_STORE_URL": "your-store.myshopify.com",
        "SHOPIFY_ACCESS_TOKEN": "shpat_xxxxxxxxxxxxxxxxxxxxx"
      }
    },
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

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 | 2026-01 | API version (or unstable for bleeding edge) | | SHOPIFY_TIER | No | STANDARD | Rate limit tier | | MCP_LOG_OPERATIONS | No | true | Enable operation logging |

Available Tools

Core Tools

| Tool | Description | |------|-------------| | get_shop_info | Retrieve store configuration, plan info, and settings | | run_graphql_query | Universal tool — Execute any GraphQL query or mutation |

Smart Tools

Multi-step workflows that handle complexity automatically:

| Tool | Description | |------|-------------| | upload_file | Upload file (URL, local path, or base64) → poll until ready → return CDN URL | | bulk_export | Start bulk query → poll completion → return JSONL download URL | | bulk_import | Staged upload → bulk mutation → poll completion | | upsert_metaobject | Create or update metaobject by handle (idempotent) | | delete_metaobject | Delete metaobject by ID or type+handle | | 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 (calls, errors, response times) |

Rate Limiting

The server automatically 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 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

# Clone the repo
git clone https://github.com/Brahim-Benzarti/Shopify_store-MCP.git
cd Shopify_store-MCP

# Install dependencies
npm install

# Build
npm run build

# Run with MCP Inspector
npm run inspect

# Watch mode
npm run dev

# View database
npm run db:studio

Database

The server uses SQLite for operation logging and configuration. Database is automatically created at ~/.shopify-mcp/mcp.db.

Security

Never commit your .env file or access tokens
Use environment variables or MCP config for credentials
Access tokens should have minimal required scopes
Operations are logged locally for debugging (disable with MCP_LOG_OPERATIONS=false)

License

ISC

Shopify Dev MCP — Official Shopify MCP for API documentation
Shopify Admin API — GraphQL API reference
Model Context Protocol — MCP specification

MCP Servers