How do I install Shopify Store?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shopify Store need an API key?

No required environment variable is listed on this record.

What transport does Shopify Store use?

Shopify Store runs locally over stdio.

When was Shopify Store last checked?

Last checked 2026-11-10. MCP server for Shopify store operations via Admin and Storefront APIs

Shopify Store MCP 서버

에이전트 강화

이 서버 추가

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code PlugMCP에서 실행

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add shopify-store-mcp -- npx -y shopify-store-mcp@1.0.10

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "shopify-store-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

PlugMCP에서 실행

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

실행

Server facts

Local

Transport: stdio
Version: 1.0.10
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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

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

이 서버 추가

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Shopify Store?

Does Shopify Store need an API key?

What transport does Shopify Store use?

When was Shopify Store last checked?

Documentation

Shopify Store MCP Server

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