Skip to main content
Glama
Sign In
Shopify MCP

Shopify MCP

by Jeanivy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Shopify MCP

Read-only Shopify Admin API MCP server for Codex business reporting.

The server exposes business-level tools for Codex instead of a raw GraphQL passthrough:

  • get_shop_summary

  • list_recent_orders

  • get_sales_report

  • list_low_inventory_products

  • search_products

Secrets are intentionally not stored in this repository. Each machine must provide its own Shopify Admin API token through SHOPIFY_SECRETS_FILE.

Install

git clone <repo-url> shopify-mcp
cd shopify-mcp
npm install

Create the local secrets file:

mkdir -p ~/.codex/secrets
chmod 700 ~/.codex/secrets
cp .env.example ~/.codex/secrets/hholove-shopify.env
nano ~/.codex/secrets/hholove-shopify.env
chmod 600 ~/.codex/secrets/hholove-shopify.env

Required values:

SHOPIFY_STORE_DOMAIN=64f8b1.myshopify.com
SHOPIFY_ADMIN_ACCESS_TOKEN=<Admin API access token>
SHOPIFY_API_VERSION=2026-04
SHOPIFY_REPORT_TIME_ZONE=Asia/Shanghai

Related MCP server: shopify-mcp

Verify

Run local tests:

npm test

Run live Shopify sanity:

SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
node scripts/shopify-query.mjs sanity

Run a Shanghai-time daily order check:

SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
node scripts/shopify-query.mjs recent-orders --today --time-zone Asia/Shanghai

Register With Codex

/Applications/Codex.app/Contents/Resources/codex mcp add hholove-shopify \
  --env SHOPIFY_SECRETS_FILE="$HOME/.codex/secrets/hholove-shopify.env" \
  -- node "$PWD/mcp/hholove-shopify-server.mjs"

Inspect the registration:

/Applications/Codex.app/Contents/Resources/codex mcp get hholove-shopify
/Applications/Codex.app/Contents/Resources/codex mcp list

Restart Codex after changing MCP registration.

The Git repository is named shopify-mcp; the Codex MCP registration name is currently hholove-shopify so it stays paired with the existing store secrets file and local Codex configuration.

Development

npm run test:hholove-shopify-mcp
npm run test:shopify-query
npm run mcp:hholove-shopify

Implementation notes live in mcp/README.md. Target-Mac setup details live in docs/hholove-shopify-mcp-transfer.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • MCP Shopify

      antoineschaller
      A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.
      25 npm
      20
      MIT

    • shopify-admin-mcp

      ChaseWNorton
      A
      license
      Not graded
      quality
      D
      maintenance
      Production-grade MCP server for the Shopify Admin GraphQL API, exposing typed tools for AI agents to manage products, orders, customers, and more.
      41 npm
      MIT

    • shopify-mcp

      weli-dev
      F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server providing six scoped tools for Shopify's Admin API, enabling natural-language querying of chargebacks, orders, refunds, customers, and revenue.
      -