shopify-mcp-server

Connects AI assistants to the Shopify Admin GraphQL API for store management.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill shopify-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shopify-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/shopify-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill shopify-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing a Shopify store through AI assistants requires a bridge to the Shopify Admin API. This Skill provides an MCP server that exposes 40 typed tools for products, orders, customers, inventory, and metafields, so Claude Desktop can perform store operations through natural language. ## Core Features & Use Cases - Store Resource Management: List, create, update, and delete products, customers, and orders via Shopify Admin GraphQL API with Zod-validated inputs. - Flexible Authentication: Supports static access tokens and OAuth client-credentials flow, with optional Redis token caching and automatic refresh. - Inventory & Metafields: Set inventory quantities per location and manage metafields on any Shopify resource. - Use Case: Ask Claude to list all unfulfilled orders created this month, then fulfill a specific order with USPS tracking information, all through MCP tool calls. ## Quick Start Set up the Shopify MCP server with my store domain and OAuth credentials so Claude can list my active products.

Frequently Asked Questions about shopify-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude Desktop to my Shopify store?▼

Add a shopify entry to claude_desktop_config.json with the npx shopify-mcp command, passing your client ID, client secret, and store domain as arguments. Restart Claude Desktop and the 40 Shopify tools become available.

What authentication methods does the Shopify MCP server support?▼

The server supports static access tokens from legacy custom apps via SHOPIFY_ACCESS_TOKEN, and OAuth client-credentials flow using SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET. CLI flags can override environment variables.

Which Shopify API scopes are required for full functionality?▼

Grant read and write scopes for products, customers, orders, inventory, and metaobjects in your Shopify custom app. Missing scopes cause the corresponding tool categories to fail with permission errors.

Why does the Shopify MCP server fail with authentication errors?▼

The error occurs when neither a static access token nor both OAuth credentials are provided. Verify SHOPIFY_ACCESS_TOKEN is set, or that SHOPIFY_CLIENT_ID and SHOPIFY_CLIENT_SECRET are both present and valid.

Does the Shopify MCP server require Redis?▼

Redis is optional and only used to cache OAuth access tokens with automatic refresh before expiry. Set REDIS_ENABLED=false to run without it, though tokens will be re-fetched more frequently.

How do I filter Shopify orders or products through MCP tools?▼

List tools accept a query parameter using Shopify search syntax, such as fulfillment_status:unfulfilled or vendor:Nike tag:running. They also support cursor-based pagination with first, after, sortKey, and reverse parameters.