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?

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

1. Node.js 18+

2. Shopify store with a custom app

3. Admin API access token — Create a custom app in Shopify Admin → Settings → Apps and development channels → Develop apps

Installation

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

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

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

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

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

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

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

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

Available Tools

Core Tools

Smart Tools

Multi-step workflows that handle complexity automatically:

Infrastructure Tools

Rate Limiting

The server automatically respects Shopify's rate limits based on your shop plan:

Use the configure tool to set your tier or auto-detect from your shop plan.

Available Prompts

Available Resources

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

Related

• Shopify Dev MCP — Official Shopify MCP for API documentation

• Shopify Admin API — GraphQL API reference

• Model Context Protocol — MCP specification