← Back to directory
S

Shopify MCP Server

Community
MCP server for Shopify Admin GraphQL API for AI assistants
GitHub source repository ↗
★ 139 Stars Category · Dev Tools Popular Source revision d9bf0a03155e
36FMRS · D
Reliability
5/20
Security and permissions
5/20
Maintenance
6/20
Documentation
11/20
Setup experience
9/20

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.

Read the FMRS scoring method →

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.

Tools

The tool list has not been reviewed yet.

Setup

  1. Ensure Node.js 18 or later is installed.
  2. Run with npx: npx shopify-mcp --clientId YOUR_CLIENT_ID --clientSecret YOUR_CLIENT_SECRET --domain your-store.myshopify.com
  3. Or install from source: clone the repository, npm install, npm run build, then npm start.
  4. 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"
      ]
    }
  }
}

Fit and risk

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

Troubleshooting

  1. Authentication errors: ensure you provide either `SHOPIFY_ACCESS_TOKEN` or both `SHOPIFY_CLIENT_ID` and `SHOPIFY_CLIENT_SECRET`
  2. 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
  3. 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`
  4. 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

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 DesktopFull support