Shopify Store Server

БесплатноHosted

Enables AI agents to interact with live Shopify stores through Admin and Storefront APIs for tasks like GraphQL execution, bulk operations, and file uploads. It

автор: Brahim-Benzarti

GitHub

Описание

Enables AI agents to interact with live Shopify stores through Admin and Storefront APIs for tasks like GraphQL execution, bulk operations, and file uploads. It includes built-in rate limiting and operation logging to manage store data and schema discovery securely.

README

npm version npm downloads License: ISC Node.js TypeScript

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

Install in Cursor

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

Как установить

Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.

{
  "mcpServers": {
    "shopify-store-mcp-server": {
      "command": "npx",
      "args": []
    }
  }
}

Shopify Store Server

Описание

README

Why This MCP?

Features

Prerequisites

Installation

Quick Install

Manual Configuration

Recommended: Add Shopify Dev MCP

Environment Variables

Available Tools

Core Tools

Smart Tools

Infrastructure Tools

Rate Limiting

Available Prompts

Available Resources

Development

Database

Security

License

Related

Как установить

Похожие MCP

Fetch

AWS KB Retrieval

Spring AI MCP Server

llm-analysis-assistant

Command Palette

Shopify Store Server

Описание

README

Why This MCP?

Features

Prerequisites

Installation

Quick Install

Manual Configuration

Recommended: Add Shopify Dev MCP

Environment Variables

Available Tools

Core Tools

Smart Tools

Infrastructure Tools

Rate Limiting

Available Prompts

Available Resources

Development

Database

Security

License

Related

Как установить

Похожие MCP

Fetch

AWS KB Retrieval

Spring AI MCP Server

llm-analysis-assistant