Shopify MCP Server

Community

MCP server for Shopify Admin GraphQL API for AI assistants

How to install ↓ Compare GitHub source repository ↗

Category: Dev Tools #380 of 438
Stars: ★ 143 Popular
Transport: stdio (local process)
Runtime: Node.js 18+ · Docker
Credentials: API key / credential required
License: MIT
Last commit: 28 days ago

36FMRS · D

Based on the README, this server is a well-crafted MCP integration for Shopify, offering 40 tools and robust features like OAuth, Redis caching, and structured logging. It is suitable for developers who want to use the Shopify Admin API within the MCP ecosystem, but requires careful handling of credentials and awareness of its non-official status.

Strongest · Documentation 11/20 Weakest · Reliability 5/20

Reliability

5/20

Security and permissions

5/20

Maintenance

6/20

Documentation

11/20

Setup experience

9/20

Why each score

Reliability 5/20: Only the README was supplied; no package.json, tool manifest, or runnable code. The 'install from source' URL points to GeLi2001/shopify-mcp instead of this repository; 40 tools are claimed but no manifest is available to verify; no CI or test evidence is present, so the MCP handshake and tool behavior cannot be confirmed.
Security and permissions 5/20: Static tokens and OAuth secrets are passed via environment variables or CLI flags, but no encryption, least-privilege, or rotation policy is described; access control for the Redis token cache is unspecified. Destructive operations such as refund, cancel, or delete lack any confirmation mechanism or data-boundary disclosure. Without source code, credential-exposure or over-permission risks cannot be ruled out.
Maintenance 6/20: The repository is not archived, has an MIT license, and shows 0 open issues, but there is no commit, release, or issue-response data; the CI mentioned in the README cannot be verified, and the inconsistent clone URL weakens evidence of active maintenance.
Documentation 11/20: The README is fairly complete and includes installation, environment variables, troubleshooting, and FAQ, but it lacks tool parameters, rate limits, cost details, and contains a wrong 'install from source' URL; there are no verifiable examples or screenshots.
Setup experience 9/20: The npx and Claude Desktop configuration examples are clear, but the npm package existence is unverified, the clone URL points to the wrong repository, and there is no CI or test evidence supporting a reproducible installation path.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

Developers who want to manage Shopify stores using AI assistants
Projects requiring programmatic access to the Shopify Admin API from MCP-compatible tools
Teams seeking a ready-made, production-grade Shopify MCP server

Not for

Users who don't need to manage a Shopify store or access the Admin API
Those seeking a server for the Shopify Storefront API (this server only uses the Admin API)
Users looking for an officially maintained MCP server (this one is not officially maintained by Shopify)

Required permissions

Shopify Admin API access, requiring a custom app with Admin API scopes including `read_products`, `write_products`, `read_customers`, `write_customers`, `read_orders`, `write_orders` (plus scopes for inventory/metafields as needed)
Optional Redis connection for OAuth token persistence (if enabled)
Credentials via environment variables or CLI arguments (access token or client ID/secret)

Risks and side effects

Credentials may be exposed: store client secrets or access tokens securely
Data loss or corruption risk due to write permissions (write operations are allowed)
Using a non-official server may introduce security or compatibility issues; review code at your own risk
Enabling Redis without proper configuration may cause startup failure or token cache issues

Setup

Before you start

Runtime：Node.js 18+ · Docker

MYSHOPIFY_DOMAIN required Your store domain, e.g. store.myshopify.com, from your Shopify store.

SHOPIFY_ACCESS_TOKEN optionalsecret Static shpat_ access token from a legacy custom app; use instead of client credentials.

SHOPIFY_CLIENT_SECRET optionalsecret Client secret from a Shopify Dev Dashboard app, paired with SHOPIFY_CLIENT_ID.

Other optional settings (8)

SHOPIFY_CLIENT_ID optional Client ID from a Shopify Dev Dashboard app (Option B auth).

SHOPIFY_API_VERSION optional Admin GraphQL API version, defaults to 2026-01.

LOG_LEVEL optional Log verbosity: debug, info, warn, or error.

REDIS_ENABLED optional Enable Redis token persistence (true/false).

REDIS_URL optional Redis connection URL, e.g. redis://127.0.0.1:6379; required if Redis is enabled.

REDIS_KEY_PREFIX optional Redis key namespace prefix, defaults to shopify-mcp:.

REDIS_MAX_RETRIES optional Max Redis command retries, default 10.

REDIS_CONNECT_TIMEOUT_MS optional Redis connect timeout in milliseconds, default 10000.

Ensure Node.js 18 or later is installed.
Run with npx: npx shopify-mcp --clientId YOUR_CLIENT_ID --clientSecret YOUR_CLIENT_SECRET --domain your-store.myshopify.com
Or install from source: clone the repository, npm install, npm run build, then npm start.
For Claude Desktop, add the provided JSON configuration to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json).

claude_desktop_config.json

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--clientId",
        "<CLIENT_ID>",
        "--clientSecret",
        "<CLIENT_SECRET>",
        "--domain",
        "<store>.myshopify.com"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-mcp",
        "--clientId",
        "<CLIENT_ID>",
        "--clientSecret",
        "<CLIENT_SECRET>",
        "--domain",
        "<store>.myshopify.com"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add shopify -- npx shopify-mcp --clientId '<CLIENT_ID>' --clientSecret '<CLIENT_SECRET>' --domain '<store>.myshopify.com'

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After adding the config to Claude Desktop and restarting, the shopify server's product/order/customer tools should appear in the client's tool list; asking it to list a few products or your shop info and getting real data back confirms the connection works.

Troubleshooting

Authentication errors: ensure you provide either `SHOPIFY_ACCESS_TOKEN` or both `SHOPIFY_CLIENT_ID` and `SHOPIFY_CLIENT_SECRET`
MCP connection issues: check Claude Desktop MCP logs (e.g., `tail -f ~/Library/Logs/Claude/mcp*.log` on macOS) and ensure the server starts without errors
Redis connection failures: if `REDIS_ENABLED=true` but Redis is unreachable, the server exits at startup. Start a local Redis (e.g., using Docker) or set `REDIS_ENABLED=false`
GraphQL userErrors: Shopify returns field-level errors in mutation responses; the server surfaces them as `Failed to <operation>: field: message`. Use these to adjust operations

Things to try

Once connected, you can ask your AI assistant things like:

List the first 10 products in my store with their inventory status
Show unfulfilled orders from the last week and summarize the total order value
Add a metafield called care_instructions to a specific product
Set the inventory quantity for a product variant to 25

Use cases

Manage products, customers, orders, inventory, and metafields in a Shopify store via an AI assistant

Automate e-commerce management tasks such as order processing, inventory updates, and customer support

Integrate MCP-compatible clients with the Shopify Admin API for data querying and operations

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

A production-oriented Model Context Protocol (MCP) server that exposes the Shopify Admin GraphQL API to AI assistants. It allows Claude Desktop, Claude Code, or any MCP-compatible client to manage products, customers, orders, inventory, and metafields through a typed tool interface. The server translates MCP tool calls into Shopify Admin GraphQL operations, supporting static access tokens and OAuth client-credentials (Dev Dashboard apps), optional Redis-backed token persistence, structured JSON logging, and graceful shutdown.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

NPM Sentinel MCP Server 79 · B

AI-powered NPM package analysis MCP server

★ 18 · Tools 19 Compare with this →

MartinLoop MCP Server 79 · B

An independent control layer that gives AI coding agents budgets, brakes, and receipts

★ 410 Compare with this →

GitHub MCP Server 76 · B

GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language

★ 33.5k · Tools 15 Compare with this →

Compare with other MCP servers

Source revision b51431925b8d Data synced 2026-10-12 Read the FMRS scoring method